WLANProfile 元素

WLANProfile 元素包含无线 LAN 配置文件。 此元素是无线配置文件的唯一根元素。

WLANProfile 元素的目标命名空间为 https://www.microsoft.com/networking/WLAN/profile/v1。

<xs:element name="WLANProfile">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="name"
                type="nameType"
             />
            <xs:element name="SSIDConfig"
                maxOccurs="256"
                ...
             />
            <xs:element name="Hotspot2"
                minOccurs="0"
                ...
             />
            <xs:element name="connectionType">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="IBSS">
                        <xs:enumeration value="ESS">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="connectionMode"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="auto">
                        <xs:enumeration value="manual">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="autoSwitch"
                minOccurs="0"
                type="boolean"
             />
            <xs:element name="MSM"
                minOccurs="0"
                ...
             />
            <xs:element name="IHV"
                minOccurs="0"
                ...
             />
            <xs:element name="MacRandomization"
                ...
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

父元素

无。

子元素

元素	类型	说明
name	nameType	WLAN 配置文件的名称。
SSIDConfig		包含一个或多个用于无线 LAN 的 SSD。
热点 2		扩展 WLAN 配置文件架构 v1 以支持热点 2.0 网络。
connectionType		指示网络是基础结构 (“ESS”) 还是临时 (“IBSS”) 。
connectionMode		指示与无线 LAN 的连接应是自动 (“auto”) ，还是由用户) (“手动”启动。 此元素为可选元素。
autoSwitch	boolean	确定当更首选的网络处于范围内时自动连接的网络的漫游行为。 此元素是可选的，对手动连接的网络没有影响。
Msm		包含各种特定于媒体的模块 (MSM) 设置。
IHV		包含独立硬件供应商的各种设置。
MacRandomization		配置 MAC 地址的随机化。

name

包含无线 LAN 配置文件的名称。

名称区分大小写。

对于具有 Service Pack 3 (SP3) 的 Windows XP 和适用于具有 Service Pack 2 (SP2) 的 Windows XP 的无线 LAN API，当配置文件保存在配置文件存储中时， 将忽略 name 元素。 配置文件的名称派生自网络的 SSID。 对于基础结构网络配置文件，配置文件的名称是网络的 SSID。 对于即席网络配置文件，配置文件的名称是即席网络的 SSID，后跟 -adhoc。 不显示 XML 转义字符，如 &。 请避免在 SSID 名称中使用 XML 转义字符，以便在具有 SP3 的 Windows XP 上部署的配置文件或适用于 Windows XP SP2 的无线 LAN API 中部署的配置文件。

对于任何只能在 Windows Vista 或 Windows Server 2008 上使用的网络配置文件，名称可以是任意字符串。

connectionType

connectionType 元素指示网络的操作模式。 值 ESS 表示基础结构网络，而 IBSS 表示临时网络。

connectionMode

connectionMode (WLANProfile) 元素指示是自动连接还是由用户启动到无线 LAN 的连接。

如果 connectionType 设置为 ESS，此值可以是自动的，也可以是手动的。 如果此元素不存在，则默认值为 auto。

如果 connectionType 设置为 IBSS，则此值必须是手动的。

<xs:element name="connectionMode">
    <xs:simpleType>
        <xs:restriction
            base="string"
        >
            <xs:enumeration
                value="auto"
             />
            <xs:enumeration
                value="manual"
             />
        </xs:restriction>
    </xs:simpleType>
</xs:element>

下表描述了枚举值。

值	说明
auto	每当网络处于范围内时，应自动启动与无线网络的连接。
manual	与无线网络的连接仅在用户的显式请求后进行初始化。

autoSwitch

确定当更首选的网络处于范围内时自动连接的网络的漫游行为。 此元素为可选元素。

如果 autoSwitch 为“true”且 connectionMode 设置为“auto”，则每当更首选的网络进入范围时，都必须尝试连接到更首选的网络。 首选网络是在首选无线网络列表中排序较高的网络。 连接到另一个网络时，会发生此连接尝试。

如果 connectionMode 设置为“auto”，则此值可以是“true”或“false”。

如果 connectionMode 设置为“manual”，则必须将此值设置为“false”。 此元素对手动连接的网络没有影响。

如果 autoSwitch 值设置为“true”，则新网络的定期扫描频率更高。 这可能会导致这些定期扫描造成的射频污染增加，并增加无线网络适配器使用的功耗。

安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2： 在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上实现了更改，以优化无线网络性能。 这些更改旨在减少无线电频率污染、功耗和无线网络上的实时流量中断。 当无线 LAN 配置文件中未设置此元素时 ，autoSwitch 的默认设置已更改。 在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上，默认设置更改为“false”。 Windows Server 2008 和 Windows Vista 上的默认设置为“true”。 建议将无线 LAN 配置文件中应用程序使用的 autoSwitch 元素的值设置为“false”，以减少定期扫描新网络的频率，除非应用程序绝对需要将此值设置为“true”。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API： 不支持此元素。

备注

WLANProfile 元素的大多数子元素都位于 命名空间中 https://www.microsoft.com/networking/WLAN/profile/v1 。 有两个例外： FIPSMode 元素位于 https://www.microsoft.com/networking/WLAN/profile/v2 命名空间中， OneX 元素位于 命名空间中 https://www.microsoft.com/networking/OneX/v1 。

若要查看树状结构中的子元素列表，请参阅 WLAN_profile架构元素。

示例

若要查看示例配置文件，请参阅 无线配置文件示例。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP SP3 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
可再发行组件	带有 SP2 的 Windows XP 无线 LAN API