This topic has not yet been rated - Rate this topic

SSID (SSIDConfig) Element

Applies to: desktop apps only

The SSID (SSIDConfig) element contains an SSID for a wireless LAN.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: At most one SSID element can appear in a profile.

Copy

<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>

The SSID element is defined by the SSIDConfig element.

Child elements

Element	Type	Description
hex		Contains the SSID of a wireless LAN in hexadecimal format.
name		Contains the SSID for a wireless LAN.

Remarks

Although the hex and name elements are optional, at least one hex or name element must appear as a child of the SSID element.

When profile information is converted to an SSID, the hex element is converted to the SSID (if present) and the name element is ignored. If the hex element is not present, the name element is converted to an SSID using Unicode to ASCII conversion.

When an SSID is stored in a profile, the hex element is always generated. The name element is only generated if the both the ASCII to Unicode conversion of the SSID and the XML profile generation are successful. Some information from the original SSID may be lost when it is converted to a name.

Examples

To view sample profiles that use the SSID element, see Wireless Profile Samples.

Requirements

Minimum supported client	Windows Vista, Windows XP with SP3
Minimum supported server	Windows Server 2008
Redistributable	Wireless LAN API for Windows XP with SP2

SSID (SSIDConfig) Element

Child elements

Remarks

Examples

Requirements

See also