SSID Element (Compact 2013)

3/26/2014

This element contains an SSID for a wireless network.

Syntax

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

Child Elements

Element	Type	Description
hex Element	Element	Contains the SSID of a wireless network, in hexadecimal format
Name Element	Element	Contains the SSID for a wireless network

Remarks

The SSID element is defined by the SSIDConfig Element.

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.

To view sample profiles that use the SSID element, see Wi-Fi Profile Samples.

See Also

Reference

Profile XML Schema Elements
SSIDConfig Element
Profile XML Schema Reference

Other Resources

Wi-Fi Profile Samples