Share via


Wi-Fi Configuration Service Provider

4/8/2010

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. Devices running on Windows Mobile Version 5.0 or later 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 and later. 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 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.

Bb737539.520539ad-91a9-443a-b6b0-2153c4181ce7(en-us,MSDN.10).gif

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

Bb737539.b739e2ec-87a1-4954-84c1-8a5bf60aeafa(en-us,MSDN.10).gif

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.

    The following table shows the default settings.

    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 EAP plug-ins.

    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.

    6

    Encrypt using Advanced Encryption Standard (AES).

    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

  • Hidden
    Specifies whether the network is hidden.

    The following table shows the possible values:

    Value Description

    0 (default)

    The network is considered a normal broadcast network.

    1

    Marks the network as hidden. The adapter needs to probe for it to be able to connect.

  • 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 configuration XML. For information about specific elements, see MSPROV DTD Elements. For general examples of how to 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

Concepts

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