Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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. ConnMgrEstablishConnectionreturns the value of this parameter. Otherwise, the value might be set to NULL.

pguidProvider

[in] Pointer to the GUIDof 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

See Also