CM_Networks Configuration Service Provider (Windows Embedded CE 6.0)

1/6/2010

The CM_Networks configuration service provider configures metanetworks, which are destination networks that multiple connectivity objects and proxies or virtual private networks (VPNs) can connect to. Each metanetwork is given a descriptive name such as "The Internet," or "My Corporate Network." Each metanetwork name has an associated GUID that identifies the metanetwork inside other connection service providers.

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.

The following image shows the configuration service provider in tree format as used by OMA client provisioning.

Characteristics

• <NetworkName>
  User-friendly, unique network name.

Parameters

• Desc.<langid>
  This parameter is used in the <NetworkName> characteristic. A tag in the format of Desc.<langid> will be used as the language-specific identifier for that network. For example, the field <parm name="Desc.0409" value="The Internet" /> will force "The Internet" to be displayed on the user interface (UI) to represent this connection when the device is set to English language (language ID 0409).

  You can provision descriptions for multiple languages. The operating system automatically switches among these languages if the user changes language preferences on the device. If a no Desc tag is provisioned for a specific language, the system defaults to the value specified in the <NetworkName> tag.

  The following table shows the default settings.

  Permissions	Read/Write
  Semantic Type	Invisible
  Roles allowed to query and update setting	Manager AuthenticatedUser

• DestID
  This parameter is used in the <NetworkName> characteristic as a globally unique identifier (GUID) that represents the unique ID of the network to which it may be connected. For predefined GUID values IID_DestNet*, which are preprovisioned, see the connmgr.h header file.

  The following table shows the default settings.

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

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
parm-query	Supported

Use these elements to build standard OMA 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