0 out of 1 rated this helpful - Rate this topic

name (SSID) Element

Applies to: desktop apps only

The name (SSID) element contains the SSID of a wireless LAN.

<xs:element name="name">
    <xs:simpleType>
        <xs:restriction
            base="string"
        >
            <xs:minLength
                value="1"
             />
            <xs:maxLength
                value="32"
             />
        </xs:restriction>
    </xs:simpleType>
</xs:element>

The element is defined by the SSID element.

Remarks

Names are case-sensitive.

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.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2:  XML escape characters, such as &, are not displayed. Avoid using XML escape characters in SSID names for profiles deployed on Windows XP with SP3 and Wireless LAN API for Windows XP with SP2.

Examples

To view sample profiles that use the name 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

See also

Definition context of element in schema
SSID
Possible immediate parent element in schema instance
SSID (SSIDConfig)

 

 

Send comments about this topic to Microsoft

Build date: 2/3/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ