WLANProfile Element (Compact 7)
3/12/2014
This element contains a wireless network profile. This element is the unique root element for a wireless profile.
Syntax
<xs:element name="WLANProfile">
<xs:complexType>
<xs:sequence>
<xs:element name="name"
type="nameType"
/>
<xs:element name="SSIDConfig"
maxOccurs="256"
>
<xs:complexType>
<xs:sequence>
<xs:element name="SSID"
maxOccurs="256"
>
<xs:complexType>
<xs:sequence>
<xs:element name="hex"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="hexBinary"
>
<xs:minLength
value="1"
/>
<xs:maxLength
value="32"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="name"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:minLength
value="1"
/>
<xs:maxLength
value="32"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="nonBroadcast"
type="boolean"
minOccurs="0"
/>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="connectionType">
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="IBSS"
/>
<xs:enumeration
value="ESS"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="connectionMode"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="auto"
/>
<xs:enumeration
value="manual"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="autoSwitch"
type="boolean"
minOccurs="0"
/>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
<xs:element name="MSM"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:element name="connectivity"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:element name="phyType"
minOccurs="0"
maxOccurs="4"
>
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="a"
/>
<xs:enumeration
value="b"
/>
<xs:enumeration
value="g"
/>
<xs:enumeration
value="n"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="security"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:element name="authEncryption">
<xs:complexType>
<xs:sequence>
<xs:element name="authentication">
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="open"
/>
<xs:enumeration
value="shared"
/>
<xs:enumeration
value="WPA"
/>
<xs:enumeration
value="WPAPSK"
/>
<xs:enumeration
value="WPA2"
/>
<xs:enumeration
value="WPA2PSK"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="encryption">
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="none"
/>
<xs:enumeration
value="WEP"
/>
<xs:enumeration
value="TKIP"
/>
<xs:enumeration
value="AES"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
encryption
Sets the data encryption to use to connect to the wireless LAN.
<xs:element name="useOneX"
type="boolean"
minOccurs="0"
/>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sharedKey"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:element name="keyType">
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="networkKey"
/>
<xs:enumeration
value="passPhrase"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
keyType
Type of key.
<xs:element name="protected"
type="boolean"
/>
<xs:element name="keyMaterial"
type="string"
/>
keyMaterial
Contains the network key or passphrase.
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="keyIndex"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="integer"
>
<xs:minInclusive
value="0"
/>
<xs:maxInclusive
value="3"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="PMKCacheMode"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="disabled"
/>
<xs:enumeration
value="enabled"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
PMKCacheMode
<xs:element name="PMKCacheTTL"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="integer"
>
<xs:minInclusive
value="5"
/>
<xs:maxInclusive
value="1400"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="PMKCacheSize"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="integer"
>
<xs:minInclusive
value="1"
/>
<xs:maxInclusive
value="255"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="preAuthMode"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="string"
>
<xs:enumeration
value="disabled"
/>
<xs:enumeration
value="enabled"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="preAuthThrottle"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction
base="integer"
>
<xs:minInclusive
value="1"
/>
<xs:maxInclusive
value="16"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="IHV"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:element name="OUIHeader">
<xs:complexType>
<xs:sequence>
<xs:element name="OUI">
<xs:simpleType>
<xs:restriction
base="hexBinary"
>
<xs:length
value="3"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="type">
<xs:simpleType>
<xs:restriction
base="hexBinary"
>
<xs:length
value="1"
/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="connectivity"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:any
processContents="lax"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="security"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:any
processContents="lax"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="useMSOneX"
type="boolean"
minOccurs="0"
/>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
Child Elements
| Element | Type | Description |
|---|---|---|
Element |
Specifies the authentication and encryption pair to be used for this profile |
|
Element |
Specifies the authentication method to be used to connect to the wireless network |
|
Boolean |
Determines the roaming behavior of an auto-connected network when a more preferred network is in range. This element is optional and does not affect a manually connected network. |
|
Element |
Indicates whether connection to the wireless network should be automatic (AUTO) or initiated by the user (MANUAL). This element is optional. |
|
Element |
Indicates whether the network is infrastructure (ESS) or ad hoc (IBSS) |
|
Element |
Contains IHV-related connectivity settings |
|
Element |
Sets the data encryption to use to connect to the wireless network |
|
Element |
Contains the SSID of a wireless network, in hexadecimal format |
|
Element |
Contains optional independent hardware vendor (IHV) settings |
|
Element |
Specifies which key index should be used to encrypt wireless traffic. This is used only when |
|
String |
Contains the network key or passphrase |
|
Element |
Type of key |
|
Element |
Contains various MSM settings. This element is optional. |
|
Name of the WLAN profile |
||
Element |
Contains the SSID of a wireless network |
|
Boolean |
Indicates whether the network broadcasts its SSID |
|
Element |
Contains a 3-byte hexBinary that identifies the IHV |
|
Element |
Identifies the IHV |
|
Element |
Specifies the 802.11 wireless network standard used on the wireless network |
|
Element |
Indicates whether PMK caching will be used. This element is valid only for WPA2-defined networks. |
|
Element |
Specifies the number of entries in the PMK cache on the client. This element is valid for WPA2-defined networks that have PMKCacheMode Element set to ENABLED, only. If |
|
Element |
Indicates the length of time, in minutes, that a PMK cache will be kept. This element is valid for WPA2-defined networks that have |
|
Element |
Determines whether preauthentication will be used by the client. Preauthentication enables WPA2 secure fast roaming. This element is valid for WPA2-defined networks that have |
|
Element |
Indicates the number of tries when preauthenticating to neighboring APs. This element is valid for WPA2-defined networks that have |
|
Boolean |
Indicates whether the key is encrypted |
|
Element |
Contains various security settings. This element is optional. |
|
Element |
Contains IHV-specific security settings. Microsoft security settings and IHV security settings are mutually exclusive. If both sets of security settings are present in the same profile, the profile is invalid. |
|
Element |
Contains the shared key information. This element is required only if WEP or PSK keys are required for the authentication and encryption pair. |
|
Element |
Specifies the SSID of the wireless network |
|
Element |
Contains one or more SSIDs together with other common settings |
|
Element |
Contains a 1 byte hexBinary that is used to differentiate network adapters that are manufactured by the same IHV |
|
Boolean |
Specifies the origin of 802.1X security settings that are used by an IHV security component. When |
|
Boolean |
Indicates whether 802.1X is used. This flag is optional. |
Remarks
The FIPSMode Element can be inserted as a child of the authEncryption element. The OneX Element element can be inserted as a child of the Security (MSM) element.
To view sample profiles, see Wi-Fi Profile Samples.
See Also
Reference
Profile XML Schema Elements
FIPSMode Element
OneX Element
Profile XML Schema Reference