ConnMgrProviderMessage
A version of this page is also available for
4/8/2010
This function provides the functionality for exchanging information with Connection Planner or connection service providers.
Syntax
HRESULT WINAPI ConnMgrProviderMessage(
HANDLE hConnection,
const GUID *pguidProvider,
DWORD *pdwIndex,
DWORD dwMsg1,
DWORD dwMsg2,
PBYTE pParams,
ULONG cbParamSize
);
Parameters
- hConnection
[in] Optional handle to the connection. ConnMgrEstablishConnection returns the value of this parameter. Otherwise, the value might be set to NULL.
- pguidProvider
[in] Pointer to the GUID of the provider.
- pdwIndex
[in] Pointer to the optional index, which is used to address multiple providers associated with the connection.
- dwMsg1
[in] General parameter 1 for this function.
- dwMsg2
[in] General parameter 2 for this function.
- pParams
[in, out] Pointer to the parameter structure for this function.
- cbParamSize
[in] Size of the parameter's structure for this function.
Return Values
This function returns the following values.
| Value | Description |
|---|---|
S_OK |
The function call was successful. |
E_ACCESSDENIED |
The calling process does not have the privileges necessary to complete the call. |
E_INVALIDARG |
One of the supplied arguments was invalid. |
E_INTERFACE |
The specified provider could not be found. |
Requirements
| Header | connmgr.h |
| Library | cellcore.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009 |
| Windows Mobile | Windows Mobile Version 5.0 and later |