SSID Schema

Note  Wireless Provisioning Services (WPS) is no longer available as of Windows Vista.

The SSID XML schema describes the list of SSIDs supported by the WISP. XML data using this schema can define one or more SSIDs.

Each SSID declaration can contain the following XML elements:

• ssid
  This element defines the SSID of the wireless network. This element is a string containing 1-32 characters.

• Priority
  If the XML data defines multiple SSIDs, the Priority element can be used to define the preference order that the Wireless Zero Configuration service uses for automatic connection to the WISP's wireless networks. SSIDs with a higher priority value are chosen in preference when multiple SSIDs are visible.

• Connection
  This element defines the wireless network's connection type. This element can be set to ESS or IBSS.

• Authentication
  This element defines the type of 802.11 authentication used on the wireless network. This element can be set to Open, Shared, WPA, or WPAPSK.

• Encryption
  This element defines the type of encryption used on the wireless network. This element can be set to None, WEP, TKIP, or CCMP.

An example of SSID XML data is described in Sample SSID XML Data.

Note   For Windows XP with SP2 and Windows Server 2003 with SP1, the only elements that are used are the ssid element (mandatory) and the Priority element (optional). The other elements described in the schema are detected from the wireless network beacon.

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema"
 targetNamespace="https://www.microsoft.com/provisioning/SSID"
 xmlns="https://www.microsoft.com/provisioning/SSID"
 elementFormDefault="qualified">

  <xs:element name="SSIDs">
    <xs:complexType>
      <xs:sequence>
        <xs:element maxOccurs="unbounded" name="ssid">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Priority" type="xs:positiveInteger"
               minOccurs="0" />
              <xs:element name="Connection" minOccurs="0" >
                <xs:simpleType>
                  <xs:restriction base="xs:string">
                    <xs:enumeration value="IBSS" />
                    <xs:enumeration value="ESS" />
                  </xs:restriction>
                </xs:simpleType>
              </xs:element>
              <xs:element name="Authentication" minOccurs="0" >
                <xs:simpleType>
                  <xs:restriction base="xs:string">
                    <xs:enumeration value="Open" />
                    <xs:enumeration value="Shared" />
                    <xs:enumeration value="WPA" />
                    <xs:enumeration value="WPAPSK" />
                  </xs:restriction>
                </xs:simpleType>
              </xs:element>
              <xs:element name="Encryption" minOccurs="0" >
                <xs:simpleType>
                  <xs:restriction base="xs:string">
                    <xs:enumeration value="None" />
                    <xs:enumeration value="WEP" />
                    <xs:enumeration value="TKIP" />
                    <xs:enumeration value="CCMP" />
                  </xs:restriction>
                </xs:simpleType>
              </xs:element>
              <xs:element name="KeyIndex" type="xs:positiveInteger"
               minOccurs="0" />
              <xs:element name="IEEE802.1X" type="xs:string"
               minOccurs="0" />
              <xs:element name="Non802.1XURL" type="xs:anyURI"
               minOccurs="0" />
            </xs:sequence>
            <xs:attribute name="Name" type="xs:string" use="required" />
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Send comments about this topic to Microsoft