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>

父元素

没有。

子元素

姓名

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

名称区分大小写。

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

对于仅用于 Windows Vista 或 Windows Server 2008 的任何网络配置文件，名称可以是任何字符串。

连接类型

connectionType 元素指示网络的运行模式。 ESS 的值表示基础结构网络，而 IBSS 表示即席网络。

connectionMode

connectionMode （WLANProfile） 元素指示与无线 LAN 的连接是自动还是由用户启动。

如果 connectionType 设置为 ESS，则此值可以是自动的或手动的。 如果缺少此元素，则默认值为自动。

如果 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>

下表描述了枚举值。

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 的默认设置已更改。 默认设置在 Windows 7 和安装了无线 LAN 服务的 Windows Server 2008 R2 上更改为“false”。 Windows Server 2008 和 Windows Vista 上的默认设置为“true”。 建议将无线 LAN 配置文件中应用程序使用的 autoSwitch 元素的值设置为“false”，以减少新网络定期扫描的频率，除非应用程序将此值设置为“true”。否则，除非应用程序绝对有必要将此值设置为“true”。

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

注解

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架构元素。

例子

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

要求