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.

Bb737539.note(en-us,MSDN.10).gifNote:
This Configuration Service Provider is supported in Windows Mobile Version 5.0 and later. There is no equivalent functionality on earlier versions.
Bb737539.note(en-us,MSDN.10).gifNote:
This Configuration Service Provider is managed over the OMA DM protocol and the OMA Client Provisioning protocol.
Bb737539.note(en-us,MSDN.10).gifNote:
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.

Bb737539.note(en-us,MSDN.10).gifNote:
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.

Bb737539.note(en-us,MSDN.10).gifNote:
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.

Bb737539.note(en-us,MSDN.10).gifNote:
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.