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.

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.

  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