Configuring the Connection Manager Using the Default Mappings and Network Information

Article
08/28/2006

The Connection Manager ships with four networks installed by default:

The Internet
My Corporate Network
WAP Network
Secure WAP Network

Having these networks preinstalled enables the user to configure Connection Manager settings, such as Point-to-Point Protocol (PPP) and proxy configuration for the device, through options on the user interface.

CM_Networks Configuration Service Provider information is loaded by default onto every Smartphone and Pocket PC for these four preinstalled networks. For an example of the default settings, see Default Settings for CM_Networks Configuration Service Provider.

For CM_NetEntries Configuration Service Provider example for a connection through the desktop, see Adding a Desktop Passthrough Entry Example.

Note The default values for the CM_Mappings and CM_Networks Configuration Service Providers do not need to be changed. However, if you want to specify different values, see CM_Mappings Configuration Service Provider and CM_Networks Configuration Service Provider for the possible values.

The following table shows the default CM_Mappings Configuration Service Provider information that is loaded by default onto every Smartphone and Pocket PC for the four network types.

Parm pattern for the value	Network name
`://./`	The Internet
`:///*`	Work
`wsp:///`	WAP Network
`wsps:///`	Secure WAP Network

In this table, the networks are ordered by index number, and the order of the networks reflects their relative priority, in order of descending priority. For information about the index parm, see CM_Mappings Configuration Service Provider.

Connection Manager uses the first matched network. The entry that has a more specific pattern must be assigned a lower index number than more general entries. The index numbers used by default map entries are used to map most general patterns, as listed below. Therefore, to make a more specific entry map to a different network (identified by GUID), the index of that entry should be lower than the entries in the following default XML example.

**Note **The first 500 index numbers (0–500) are reserved for Microsoft use. Mobile operators should not use these numbers.

The following truncated XML example contains the map entries described in the preceding text:

<characteristic type="CM_Mappings">
   <characteristic type="1000">
      <parm name="pattern" value="wsp://*/*" /> 
      <parm name="network" 
      value="{7022E968-5A97-4051-BC1C-C578E2FBA5D9}" /> 
   </characteristic>
   <characteristic type="1200">
      <parm name="pattern" value="wsps://*/*" /> 
      <parm name="network" 
      value="{F28D1F74-72BE-4394-A4A7-4E296219390C}" /> 
   </characteristic>
   <characteristic type="1400">
      <parm name="pattern" value="*://*.*/*" /> 
      <parm name="network" 
      value="{436EF144-B4FB-4863-A041-8F905A62C572}" /> 
   </characteristic>
   <characteristic type="1500">
      <parm name="pattern" value="*://*/*" /> 
      <parm name="network" 
      value="{A1182988-0D73-439e-87AD-2A5B369F808B}" /> 
   </characteristic>
</characteristic>

The default configuration XML file that contains all of the previous information is in one of the following ROM regions:

On Smartphone, it is put in the SMARTFON region.
On Pocket PC, it is put in the MISC region.

Share via

Configuring the Connection Manager Using the Default Mappings and Network Information

See Also

Additional resources