CM_NetEntries Configuration Service Provider

The CM_NetEntries Configuration Service Provider configures additional network entries such as Desktop Passthrough (DTPT) or Wired Netcard, on Microsoft Windows Mobile™-based Smartphone and Windows Mobile™-based Pocket PC.

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.

The CM_NetEntries Configuration Service Provider is used to configure an association with Internet or Private networks on Pocket PC.

The nocharacteristic tag will work on the top two levels to delete all, or specific, entries.

The following table shows the default settings.

Permissions Read/write
Roles allowed to query and update setting Operator

Operator - TPS

Manager

AuthenticatedUser

Characteristics

  • <entryname>
    User-friendly, unique name for the network connection. This characteristic sets the name of the connection. This parameter also typically identifies which type of network connection is defined by the characteristic, for example, CurrentDTPTNetwork or CurrentWirelessNetwork.

Parms

  • Desc.<langid>
    Used in the <entryname> characteristic. A tag in the format of Desc.<langid> is used as the language-specific identifier for that entry. For example, if the field <parm name="Desc.0409" value="GPRS Connection" /> is set, "GPRS Connection" appears in the UI to identify this connection when the device is set to the English language (language ID 0409).

    Descriptions for multiple languages may be provisioned using this mechanism, and the operating system automatically switches among them if the user changes language preferences on the device. If no <Desc> tag is provisioned for a specific language, the system defaults to the characteristic tag name used to create the entry.

  • DestId
    Used in the <entryname> characteristic as a GUID that represents the unique ID of the network to which this entry connects. See the Connmgr.h header for predefined GUID values IID_DestNet*.

    The following table shows the default values.

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

    AuthenticatedUser

Elements

Elements Available
noparm No
nocharacteristic Yes
characteristic-query Yes
parm-query Yes

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile| CM_NetEntries Configuration Service Provider

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.