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.
Remarks
This is a privileged function. For more information about Smartphone security and privileged APIs, see the "Operating System Security" topic in the Mobile Device Adaptation Kit.
Requirements
Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: connmgr.h
Library: cellcore.lib
See Also
Connection Manager API Functions
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.