SSIDConfig (WLANProfile) element

The SSIDConfig (WLANProfile) element contains one or more SSIDs for wireless LANs. SSID maxOccurs is 1000 in v2; in v1, it's 256.

<xs:element name="SSIDConfig"
    maxOccurs="256"
 >
    <xs:complexType>
        <xs:sequence>
            <xs:element name="SSID"
                maxOccurs="1000"
                ...
             />
            <xs:element name="SSIDPrefix"
                ...
             />
            <xs:element name="nonBroadcast"
                minOccurs="0"
                type="boolean"
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

Parent elements

Child elements

Element Type Description
SSID Contains an SSID for a wireless LAN.
SSIDPrefix Contains an SSID prefix for a wireless LAN.
nonBroadcast boolean Indicates whether the network broadcasts its SSID.
If connectionType is set to ESS, this value can be either TRUE or FALSE. The default value is TRUE if this element is absent.
If connectionType is set to IBSS, this value must be FALSE.
Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: This element isn't supported.

nonBroadcast

Specifies whether to connect to a hidden network. If a network doesn't broadcast its SSID, then it's known as a hidden network. If multiple SSIDs are set within the profile, then they must all have the same nonBroadcast value.

If connectionType is set to ESS, then nonBroadcast can be either "true" or "false". If this element is not present, the default value is "false".

If connectionType is set to IBSS, then nonBroadcast must be "false". If nonBroadcast isn't present, then the default value is "false".

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: This element isn't supported.

Examples

To view sample profiles that use the SSIDConfig element, see Wireless profile samples. To view a sample profile that uses the nonBroadcast element, see Non-Broadcast profile sample.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP3 [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Redistributable Wireless LAN API for Windows XP with SP2