Configuration Service Providers Overview (Windows Embedded CE 6.0)

1/6/2010

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 CE 6.0 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) and wireless LAN (WLAN), on the device.	CSPNet.dll
CM_PPPEntries	Configures the Point-to-Point Protocol (PPP) entries on the device.	CSPRas.dll
CM_GPRSEntries	Configures general packet radio service (GPRS) connections.	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

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 CE powered device.

For more information about the syntax of an XML provisioning file that configures CM_NetEntries, see CM_NetEntries Configuration Service Provider. For an XML example for configuring a wireless LAN (WLAN) connection with CM_NetEntries, see Configuring a Wireless LAN Connection Example.

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. **

For more information about the syntax of an XML provisioning file that configures CM_PPPEntries, see CM_PPPEntries Configuration Service Provider.

CM_GPRSEntries Configuration Service Provider

The CM_GPRSEntries configuration service provider configures general packet radio service (GPRS) connections.

For more information about the syntax of an XML provisioning file that configures CM_GPRSEntries, see CM_GPRSEntries Configuration Service Provider. For an XML example for configuring a GPRS connection, see Configuring a GPRS Connection Example.

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 CM_Networks Configuration Service Provider.

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 CM_Planner Configuration Service Provider.

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 CM_Mappings Configuration Service Provider.

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 Device Connection Settings by using OMA XML

Other Resources

Configuration Service Providers
Connection Manager Configuration