Wi-Fi Configuration Service Provider

Send Feedback

The Wi-Fi Configuration Service Provider configures or queries Wi-Fi settings. To use this Configuration Service Provider, the Wi-Fi driver must be loaded. This means that the Wi-Fi hardware must be powered on or in a suspended state. New devices in the Windows Mobile Version 5.0 lifecycle may keep their Wi-Fi drivers always loaded for this purpose, but earlier hardware typically unloads the driver entirely when the hardware switch is OFF.

Note   This Configuration Service Provider is supported in Windows Mobile Version 5.0. There is no equivalent functionality on earlier versions.

Note   This Configuration Service Provider is managed over the OMA DM protocol and the OMA Client Provisioning (formerly WAP) protocol.

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 about roles, see Security Roles and Default Roles for Configuration Service Providers.

Settings can be changed by the manager or administrator, or by a WAP trusted provisioning server.

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

Operator TPS

The following image shows the management object used by OMA DM.

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

Characteristics

  • access-point
    Specifies access-point (infrastructure mode) networks.
  • ad-hoc
    Specifies device-to-device networks.
  • SSID
    Specifies the name of the network to create, configure, query, or delete. This characteristic is a second-level characteristic for either the access-point or ad-hoc characteristic.

Parms

  • AdHoc
    Corresponds to the AdHoc checkbox in the user interface.

Note   This parameter should not be used for provisioning. OEM's should instead provision networks under ./Vendor/MSFT/Wi-Fi/Access-Point or ./Vendor/MSFT/Wi-Fi/Ad-Hoc to specify the network type.

  • Authentication
    Specifies the Wi-Fi authentication method for the network. You can set or query the value. The following table shows the possible values:

    Value Description
    0 (default) Specifies open authentication mode.
    1 Specifies shared authentication mode.
    3 Specifies Wi-Fi Protected Access (WPA) authentication. Valid for access-point connections.
    4 Specifies WPA-PSK authentication mode, WAP in combination with a pre-shared key. Valid for access-point connections.
    5 Specifies WPA-NONE. Valid for ad-hoc connections.

    For more information about these authentication modes, see

    Permissions Read/Write
    Data type Integer
    Label Authentication:
  • DestId
    Specifies the GUID for the destination network. You can set or query the value. The following table shows the possible values.

    Value Description
    "{436EF144-B4FB-4863-A041-8F905A62C572}" (default) The Internet
    "{A1182988-0D73-439e-87AD-2A5B369F808B}" Work

    The following table shows the default settings.

    Permissions Read/Write
    Data type string
    Label Network Type:
  • EAPType
    Specifies the Extensible Authentication Protocol (EAP) plug-in driver to use for the network. You can set or query the value. The value is a valid identifier for an EAP plug-in that has been installed on the device, as specified in the registry. The following table shows the plug-ins that ship with Windows Mobile Version 5.0.

    Value Description
    13 Smart Card or Certificate (EAP-TLS)
    25 (default) Protected EAP (PEAP)

    The following table shows the default settings.

    Permissions Read/Write
    Data type integer
    Label EAP Type:
  • Encryption
    Specifies the encryption technique of the network. You can set or query the value. The following table shows the possible values:

    Value Description
    0 (default) Encrypt using 802.11 wired equivalent privacy (WEP) key.
    1 No encryption.
    4 Encrypt using Temporal Key Integrity Protocol (TKIP) sequence counters.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Integer
    Label Data encryption:
  • Filter
    Specifies the filter mode for the Wi-Fi hardware. You can set or query the value.

    The following table shows the possible values:

    Value Description
    0 Allows connection only to device-to-device (ad-hoc) networks.
    1 Allows connection only access point networks.
    2 (default) Allows connection to all available networks.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Integer
  • KeyIndex
    Specify the network key index. The value can be any integer from 1 to 4. The default value is 1.

    Note   This parm applies only to WEP-encrypted networks. You can set or query the value.

    The following table shows the default settings.

    Permissions Read/Write
    Data type integer
    Label Key index:
  • KeyProvided
    Turns on or off the Wi-Fi network automatic key flag.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Boolean
    Label The key is automatically provided.
  • NetworkKey
    Specifies the network key in ASCII or hexadecimal. You can set or query the value. The maximum length of this value is 64 characters.

    Note   This parm is stored and sent as plain text. You should make sure you transmit XML that contains this setting in a secure manner since access to the XML provides access to the network key.

    The following table shows the default settings.

    Permissions Read/Write
    Data type string
    Label Network key:
    Semantic type alphanumeric-password
  • Use8021x
    Turns on or off the Wi-Fi network 802.1x flag.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Boolean
    Label Use IEEE 802.1x network access control

Microsoft Custom Elements

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

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

Recursive: Yes

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

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

See Also

Configuration Service Provider Reference for Windows Mobile-Based Devices | Wi-Fi Configuration Service Provider Examples for OMA Client Provisioning

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.