9/19/2008
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.
.gif) 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.
- 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.
- 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.
|
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.
Concepts
Configuration Service Provider Reference for Windows Mobile Powered Devices
Wi-Fi Configuration Service Provider Examples for OMA Client Provisioning