HotspotProfile 結構描述

發行項
08/31/2023

HotspotProfile 架構定義的元素可用來描述使用無線網際網路服務提供者漫遊 (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 是 Wi-Fi 熱點設定檔的唯一根項目，使用無線網際網路服務提供者漫遊 (WISPr) 通訊協定。
密碼	用於進行 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 使用者代理程式字串，以支援操作員特定的使用者代理程式篩選。這是選擇性的項目。
使用者名稱	用於進行 WISPr 驗證的使用者名稱。
hex	以十六進位格式定義無線區域網路的 SSID。
hexPrefix	定義其 Ssid 以提供的位元組開頭的無線區域網路類別。
name	以英數位元格式定義無線區域網路的 SSID。
namePrefix	定義 Ssid 的無線區域網路類別，其 Ssid 以提供的字元開頭。

共用方式為

HotspotProfile 結構描述

意見反應

其他資源