CM_Mappings Configuration Service Provider

The CM_Mappings Configuration Service Provider configures the URL mapping table that determines the network where the URL resides.

Note Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information, see Security Roles.

It is necessary to provision a network GUID using the CM_Mappings Configuration Service Provider before provisioning anything that requires a network GUID. If the GUID already exists, it will be overwritten.

The following table shows the default settings.

Characteristics

• <MappingIndex>
  Specifies settings for the <MappingIndex> parameter. Entries in the mapping table are provisioned and ordered by their MappingIndex value. When mapping URLs, the URL mapper searches the table, starting at the lowest table ID and moving up the list of values until a matching pattern is found. Entries do not need to be contiguous.

  The first 500 index numbers (0-500) are reserved for internal use only. Do not use these numbers. The order of the networks as specified by the index number in the mapping table reflects their relative priority in a descending order. Connection Manager uses the first matching network to establish a connection.

  Entries with more specific pattern must be assigned a lower index number than more general entries. The index numbers 1000, 1200, 1400 and 1500 are used to map the most general patterns, as shown in the following table.

  Parm pattern value	Network name
  *://*.*/*	The Internet
  *://*/*	My Corporate Network
  wsp://*/*	WAP Network
  wsps://*/*	Secure WAP Network

  To make a more specific entry map to a different network (GUID), the index of that entry should be lower than the entries in the default XML example.

Parms

• Network
  Used in the <MappingIndex> characteristic to provide the Network GUID where the URL resides.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Network GUID
  Roles allowed to query and update setting	Manager AuthenticatedUser

• Pattern
  Used in the <MappingIndex> characteristic to provide the URL pattern in a wildcard pattern that is used to match the URL string. The string must be in canonicalized URL format. For example, a blank space in the URL should be converted to the escape sequence %20.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	URL Pattern
  Semantic Type	url
  Roles allowed to query and update setting	Manager AuthenticatedUser

Elements

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile Devices| CM_Mappings Configuration Service Provider Examples| Configuring the Connection Manager Using the Default Mappings and Network Information

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.