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.
Permissions | Read/Write |
Roles allowed to query and update setting | Manager
AuthenticatedUser |
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
Elements | Available |
---|---|
noparm | No |
nocharacteristic | Yes |
characteristic-query | Yes recursive query: Yes |
parm-query | Yes |
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
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.