CM_Mappings Configuration Service Provider

4/8/2010

The CM_Mappings Configuration Service Provider configures the URL mapping that is used by the ConnMgrMapURL function to determine the meta-network where the URL resides.

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

Note

This Configuration Service Provider is managed over the OMA Client Provisioning (formerly WAP Client Provisioning) protocol. To provision devices using the OMA DM protocol, use the ACCESS Configuration Service Provider instead. 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.

Bb737334.94fe90b3-6c30-4b92-88dc-ad8a3b704c4c(en-us,MSDN.10).gif

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 ConnMgrMapURL searches the table, starting at the lowest MappingIndex and moving up the list of values 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 for internal use only. User defined exceptions start at 0x01000000 (16777216). By default, the index numbers 0x20000000 (536870912), 0x21000000 (553648128), 0x22000000 (570425344) and 0x23000000 (587202560), are used to map URL strings to the default meta-networks, 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 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

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

noparm

No

nocharacteristic

Yes

characteristic-query

Yes recursive query: Yes

parm-query

Yes

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

CM_Mappings Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Devices

Other Resources

ConnMgrMapURL