CM_WiFiEntries Configuration Service Provider (PPC Only)

The CM_WiFiEntries Configuration Service Provider configures the Wireless Network (WiFi) entries on 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.

Note This Configuration Service Provider is not available on Windows Mobile-based Smartphone.

The CM_WiFiEntries Configuration Service Provider is used to configure a wireless network 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 CM_WiFiEntries Configuration Service Provider can be configured in the following ways:

  • The user enters the association to configure the wireless network to the Internet or Private network, and then the user interface (UI) component calls Connection Manager again with the new setting. Connection Manager would, in turn, store this setting.
  • A corporation pre-configures a device prior to rollout with the information about their WiFi network and its metanetwork association.
  • The configuration information for the metanetwork association is updated through over-the-air (OTA) configuration of these parameters.

The following table shows the default settings.

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

AuthenticatedUser

Characteristics

  • <entryname>
    User-friendly, unique network name. Some possible networks are MSFTINET or MSFTWLAN. Used as the name of an 802.11 wireless network connection. Fields under this characteristic specify parameters for this connection.

    Note  A slash mark (\) and quotation mark (") are not valid characters in the network name.

Parms

  • DestId
    This parm is 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*.

    Note  The only two valid networks for Pocket PC are Internet and Corporate/Private Network.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    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 Devices| CM_WiFiEntries Configuration Service Provider Examples

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.