ConnMgrProviderMessage

The ConnMgrProviderMessage function provides the means to exchange information with planners and providers.

Syntax

HRESULT WINAPI ConnMgrProviderMessage(
  HANDLE hConnection,
  const GUID * pguidProvider,
  DWORD * pdwIndex,
  DWORD dwMsg1,
  DWORD dwMsg2,
  PBYTE pParams,
  ULONG cbParamSize 
);

Parameters

  • hConnection
    An optional handle to the current connection; ConnMgrEstablishConnection returns the value of this parameter. Otherwise, the value might be set to NULL.
  • pguidProvider
    Pointer to the globally unique identifier (GUID) of the provider.
  • pdwIndex
    Optional pointer to a DWORD index value; used to address multiple providers associated with a single connection.
  • dwMsg1
    General parameter 1.
  • dwMsg2
    General parameter 2.
  • pParams
    Pointer to the parameter's data structure.
  • cbParamSize
    Size of the parameter's data structure.

Return Values

  • S_OK
    The call was made successfully.
  • E_NOINTERFACE
    No provider could be found.
  • Other error messages
    Provider-specific error messages.

Requirements

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later
Header: connmgr.h
Library: cellcore.lib

See Also

Connection Manager

Connection Manager API Functions

ConnMgrEstablishConnection

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.