CM_Mappings Configuration Service Provider (Windows Embedded CE 6.0)

1/6/2010

You can use the CM_Mappings configuration service provider to configure the URL mapping that the ConnMgrMapURL function uses to determine which metanetwork the URL resides on.

The metanetwork GUID must be provisioned using the CM_Networks Configuration Service Provider before provisioning a URL mapping to the metanetwork or anything that requires the metanetwork GUID.

Note

This configuration service provider is managed over the Open Mobile Alliance (OMA) client provisioning (formerly WAP client provisioning) protocol. For more information about OMA client provisioning, see Configuring Device Connection Settings by using OMA XML. 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.

The following table shows the default settings. The default security role maps to each subnode unless specific permission is granted to the subnode.

Permissions	Read/Write
Roles allowed to query and update setting	Manager

The following image shows the Configuration Service Provider in tree format as used by OMA client provisioning.

Characteristics

• <MappingIndex>
  Specifies information to use for URL mapping. Entries in the mapping table are provisioned and ordered by their MappingIndex number, which is specified by using the characteristic type attribute. When mapping URLs, the ConnMgrMapURL searches the table, starting at the lowest MappingIndex and moving up the list of index numbers from lowest to highest until the first matching pattern is found. Entries with a more specific pattern must be assigned a lower index number than the more general entries. Entries do not need to be contiguous.

  The first 500 index numbers (0-500) are reserved. User defined exceptions start at 0x10000000 (). By default, the index numbers 0x20000000 (536870912), 0x21000000 (553648128), 0x22000000 (570425344) and 0x23000000 (587202560) are used to map URL strings to the default metanetworks, as shown in the following table.

  Parameter pattern value	Index Number	Network name
  *://*.*/*	570425344	The Internet
  *://*/*	587202560	Work
  wsp://*/*	536870912	The WAP Network
  wsps://*/*	553648128	Secure WAP Network

Parameters

• 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

• 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 canonical 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

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this configuration service provider supports for OMA client provisioning.

Element Name	Description
noparm	Not supported
nocharacteristic	Supported
characteristic-query	Supported, including the recursive attribute
parm-query	Supported

Use these elements to build standard OMA client provisioning (formerly WAP client provisioning) configuration XML. For more information about these elements, see https://go.microsoft.com/fwlink/?LinkId=160786.

For more information about OMA client provisioning, see Configuring Device Connection Settings by using OMA XML.

See Also

Concepts

Configuration Service Providers Overview

Other Resources

Configuration Service Providers