Configuration Service Providers for Connection Manager

10/16/2008

Applies to Windows Embedded NavReady

Configuration Service Providers execute configuration requests by changing or querying the values of settings.

The following table shows the class of Configuration Service Providers supported by Windows Embedded NavReady that use the Open Mobile Alliance (OMA) Client Provisioning protocol, formerly known as the Wireless Application Protocol (WAP) Client Provisioning protocol.

Choose one of these Configuration Service Providers to configure a connection to be more secure, or to configure an AlwaysOn connection.

Configuration Service Provider	Description	CSP
CM_NetEntries	Configures additional network entries, such as ActiveSync Desktop Pass-through (DTPT), on the device.	CSPNet.dll
CM_PPPEntries	Configures the Point-to-Point Protocol (PPP) entries on the device.	CSPRas.dll
CM_Networks	Configures the metanetworks, such as the Internet, on the device.	ConnCfg.dll
CM_Planner	Configures the preferred connections for Connection Manager.	ConnPlan.dll
CM_Mappings	Configures the URL mapping table that determines the network where the URL resides.	ConnCfg.dll

Note

Provisioning of hands-free phone connections that use CSPBTVoice is not supported.

CM_NetEntries Configuration Service Provider

The CM_NetEntries Configuration Service Provider configures additional network entries, such as ActiveSync Desktop Pass-through (DTPT), on a Windows Embedded NavReady powered device.

For more information about the syntax of an XML provisioning file that configures CM_NetEntries, see the Windows Mobile content at this Microsoft Web site.

For XML examples for configuring the CM_NetEntries Configuration Service Provider, see the Windows Mobile content at this Microsoft Web site.

CM_PPPEntries Configuration Service Provider

The CM_PPPEntries Configuration Service Provider configures the Point-to-Point Protocol (PPP) entries on the device. Settings for RAS connections are defined in this Configuration Service Provider. General Packet Radio Service (GPRS) connections are configured by using the CM_GPRSEntries Configuration Service Provider.

For more information about the syntax of an XML provisioning file that configures CM_PPPEntries, see the Windows Mobile content at this Microsoft Web site.

For XML examples for configuring the CM_PPPEntries Configuration Service Provider, see the Windows Mobile content at this Microsoft Web site.

CM_Networks

The CM_Networks Configuration Service Provider configures metanetworks, destination networks to which multiple connectivity objects can connect.

For more information about the syntax of an XML provisioning file that configures CM_Networks, see the Windows Mobile content at this Microsoft Web site.

CM_Planner

The CM_Planner Configuration Service Provider configures the preferred connections for each network for Connection Manager. The CM_Planner Configuration Service Provider can also set the settings for those connections.

For more information about the syntax of an XML provisioning file that configures CM_Planner, see the Windows Mobile content at this Microsoft Web site.

CM_Mappings

The CM_Mappings Configuration Service Provider configures the URL mapping table that determines the network where the URL resides. You can configure URL exceptions using CM_Mappings; that is, you can use many URL patterns for one network.

For more information about the syntax of an XML provisioning file that configures CM_Mappings, see the Windows Mobile content at this Microsoft Web site.

Connection Establishment

To establish a connection in application code by using Connection Manager, you can either supply the GUID for the destination network or supply a Connection GUID, which is returned from calling ConnMgrMapConRef. The destination network GUID is defined in the XML provisioning file. In the following example XML code for the PPPEntries Configuration Service Provider, the value attribute in the <parm> element is the GUID that you put into the CONNMGR_CONNECTIONINFO structure that you pass into ConnMgrEstablishConnection:

<characteristic type="CM_PPPEntries">
  <characteristic type="BTGRPS_RAS">
      <parm name="DestId" value="{436EF144-B4FB-4863-A041-
                                    8F905A62C572"}/>
     ... 
  </characteristic>
</characteristic>

See Also

Concepts

Configuring a Portable Navigation Device by using OMA Client-based XML

Other Resources

Connection Manager Configuration for Portable Navigation Devices