Элемент WLANProfile

Статья
06/26/2023

Элемент WLANProfile содержит профиль беспроводной локальной сети. Этот элемент является уникальным корневым элементом для беспроводного профиля.

Целевое пространство имен для элемента https://www.microsoft.com/networking/WLAN/profile/v1WLANProfile.

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

Родительские элементы

Нет.

Дочерние элементы

Элемент	Тип	Description
name	nameType	Имя профиля WLAN.
SSIDConfig		Содержит один или несколько SSID для беспроводных локальных сетей.
Точка 2		Расширяет схему профиля WLAN версии 1 для поддержки сетей 2.0.
connectionType		Указывает, является ли сеть инфраструктурой ("ESS") или нерегламентированным ("IBSS").
connectionMode		Указывает, должно ли подключение к беспроводной локальной сети быть автоматическим ("автоматически") или инициировано (вручную) пользователем. Этот элемент является необязательным.
autoSwitch	boolean	Определяет поведение роуминга сети с автоматическим подключением, если более предпочтительная сеть находится в диапазоне. Этот элемент является необязательным и не влияет на сеть, подключенную вручную.
МСМ		Содержит различные параметры модуля для конкретных носителей (MSM).
IHV		Содержит различные параметры для независимых поставщиков оборудования.
MacRandomization		Настраивает случайность MAC-адресов.

name

Содержит имя профиля беспроводной локальной сети.

Имя учитывает регистр.

Для Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2) элемент имени игнорируется при сохранении профиля в хранилище профилей. Имя профиля является производным от SSID сети. Для профилей сети инфраструктуры имя профиля — SSID сети. Для нерегламентированных профилей сети имя профиля — SSID нерегламентированной сети, за которой следует -adhoc. Экранные символы XML, такие как >, не отображаются. Избегайте использования XML-escape-символов в именах SSID для профилей, развернутых в Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).

Для любого сетевого профиля, предназначенного только для Windows Vista или Windows Server 2008, имя может быть любой строкой.

connectionType

Элемент connectionType указывает режим работы сети. Значение ESS указывает сеть инфраструктуры, а IBSS — нерегламентированная сеть.

connectionMode

Элемент connectionMode (WLANProfile) указывает, должно ли подключение к беспроводной локальной сети автоматически или инициировано пользователем.

Если параметр 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>

В следующей таблице описываются значения перечисления.

значение	Описание
авто	Подключение к беспроводной сети должно быть инициировано автоматически, когда сеть находится в диапазоне.
manual	Подключение к беспроводной сети выполняется только по явному запросу пользователя.

autoSwitch

Определяет поведение роуминга сети с автоматическим подключением, если более предпочтительная сеть находится в диапазоне. Этот элемент является необязательным.

Если параметр autoSwitch имеет значение true, а параметр connectionMode имеет значение auto, подключение к более предпочтительной сети должно выполняться всякий раз, когда более предпочтительная сеть входит в диапазон. Более предпочтительная сеть — это сеть, упорядоченная выше в списке предпочтительных беспроводных сетей. Эта попытка подключения возникает при подключении к другой сети.

Если параметр connectionMode имеет значение auto, это значение может иметь значение true или false.

Если параметр connectionMode имеет значение "manual", это значение должно иметь значение false. Этот элемент не влияет на подключенную вручную сеть.

Значение autoSwitch с значением true приводит к повышению частоты периодического сканирования новых сетей. Это может привести к увеличению загрязнения радио частоты из этих периодических проверок и увеличению потребления энергии, используемой беспроводным сетевым адаптером.

Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети: изменения реализованы в Windows 7 и Windows Server 2008 R2 с беспроводной локальной сетью, установленной для оптимизации производительности беспроводной сети. Эти изменения предназначены для уменьшения загрязнения радиосвязи, потребления электроэнергии и нарушения трафика в режиме реального времени через беспроводные сети. Параметр по умолчанию для autoSwitch , если этот элемент не задан в профиле беспроводной локальной сети, изменился. Параметр по умолчанию изменяется на false в Windows 7 и Windows Server 2008 R2 с установленной беспроводной локальной сетью. Параметр по умолчанию был "true" в Windows Server 2008 и Windows Vista. Рекомендуется задать значение false для элемента autoSwitch , используемого приложением в профиле беспроводной локальной сети, чтобы уменьшить частоту периодического сканирования для новых сетей, если приложение не обязательно задать для этого значения значение true.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (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 "Элементы схемы".

Примеры

Сведения о просмотре примеров профилей см. в примерах профилей беспроводной сети.

Requirements

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Распространяемые компоненты	API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)

Поделиться через