HotspotProfile 架构

项目
08/31/2023

HotspotProfile 架构定义的元素用于描述使用无线 Internet 服务提供商漫游 (WISPr) 协议的 Wi-Fi 热点的登录凭据。所有元素都位于命名空间 http://www.microsoft.com/networking/WLAN/HotspotProfile/v1 中。并非所有元素都在每个配置文件中，因为某些元素是可选的。

完整的 HotspotProfile 架构如下：

<?xml version="1.0" encoding="UTF-8"?>  
<xs:schema targetNamespace="http://www.microsoft.com/networking/WLAN/HotspotProfile/v1"  
    elementFormDefault="qualified"  
    xmlns="http://www.microsoft.com/networking/WLAN/HotspotProfile/v1"  
    xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  
  <xs:element name="BasicAuth">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="UserName" type="xs:token"/>  
        <xs:element name="Password" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="ExtAuth">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="ExtensionId" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="TrustedDomains">  
    <xs:annotation>  
      <xs:documentation xml:lang="en">  
        The element contains a set of host names that are trusted for providing credentials over HTTPS.  
        A domain name is either a fully qualified name such as hotspot.contoso.com  
        or a wildcard such as .contoso.com to refer to all hosts under the given domain name.  
      </xs:documentation>  
    </xs:annotation>  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="TrustedDomain" maxOccurs="unbounded" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="SSIDConfig">  
    <xs:annotation>  
      <xs:documentation xml:lang="en">  
        The element contains a set of additional SSID's that are handled by this profile  
        to reduce the number of SSID's in the WLAN profile store.  
        Windows will not auto-connect to these SSID's until a user manually connects  
        and sets the auto-connect flag for a specific SSID.  
      </xs:documentation>  
    </xs:annotation>  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="SSID" maxOccurs="250">  
          <xs:complexType>  
            <xs:choice>  
              <xs:element name="hex">  
                <xs:simpleType>  
                  <xs:restriction base="xs:hexBinary">  
                    <xs:minLength value="1" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="hexPrefix">  
                <xs:simpleType>  
                  <xs:restriction base="xs:hexBinary">  
                    <xs:minLength value="4" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="name">  
                <xs:simpleType>  
                  <xs:restriction base="xs:string">  
                    <xs:minLength value="1" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="namePrefix">  
                <xs:simpleType>  
                  <xs:restriction base="xs:string">  
                    <xs:minLength value="4" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
            </xs:choice>  
          </xs:complexType>  
        </xs:element>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="HotspotProfile">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:choice>  
          <xs:sequence>  
            <xs:element ref="BasicAuth"/>  
            <xs:element ref="TrustedDomains"/>  
          </xs:sequence>  
          <xs:sequence>  
            <xs:element ref="ExtAuth"/>  
            <xs:element ref="TrustedDomains" minOccurs="0"/>  
          </xs:sequence>  
        </xs:choice>  
        <xs:element name="UserAgent" minOccurs="0" type="xs:token"/>  
        <xs:element ref="SSIDConfig" minOccurs="0"/>  
  
        <!-- extension point -->  
        <xs:any processContents="lax" namespace="##other" minOccurs="0" maxOccurs="unbounded"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
</xs:schema>

下表列出了此架构中的所有元素，并按名称的字母顺序排序。

元素	说明
BasicAuth	包含 WISPr 身份验证所需的用户名和密码。使用 BasicAuth 允许使用一组静态凭据;使用 ExtAuth 使应用为 WISPr 身份验证生成凭据。
ExtAuth	包含用于通过应用程序 (处理 WISPr 身份验证的参数，而不是通过 BasicAuth ) 指定静态用户名和密码。
ExtensionId	将调用以处理 WISPr 身份验证的应用的包系列名称。
HotspotProfile	为 Wi-Fi 热点定义属性和登录凭据。 HotspotProfile 是使用无线 Internet 服务提供商漫游 (WISPr) 协议的 Wi-Fi 热点配置文件的唯一根元素。
密码	用于 WISPr 身份验证的密码。
SSID	此配置文件处理的其他 SSID。
SSIDConfig	包含一组由此配置文件处理的附加 Ssid，以减少 WLAN 配置文件存储中 Ssid 的数目。在用户手动连接一次之前，Windows 不会连接到这些 ssid。新创建的配置文件将继承此配置文件中的 HotspotAuth 设置。
TrustedDomain	受信任的主机名，可通过 HTTPS 提供凭据。可以是完全限定名称 (如 hotspot.contoso.com) 或通配符，以引用给定域名下的所有主机 (如 contoso.com) 。
TrustedDomains	包含一个或多个主机名的集合，这些名称受信任，可以通过 HTTPS 提供凭据。可以是完全限定名称 (如 hotspot.contoso.com) 或通配符，以引用给定域名下的所有主机 (如 contoso.com) 。
UserAgent	自定义 HTTP 用户代理字符串，用于支持操作员特定的用户代理筛选。此元素为可选元素。
UserName	要用于 WISPr 身份验证的用户名。
hex	以十六进制格式定义无线 LAN 的 SSID。
hexPrefix	定义一类无线 Lan，其 Ssid 以提供的字节开头。
name	以字母数字格式定义无线 LAN 的 SSID。
namePrefix	定义一类无线 Lan，其 Ssid 以提供的字符开头。

通过

HotspotProfile 架构

反馈

反馈

其他资源