Функция WlanHostedNetworkSetProperty (wlanapi.h)

Статья
03/15/2023

Функция WlanHostedNetworkSetProperty задает статические свойства беспроводной размещенной сети.

Синтаксис

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Параметры

[in] hClientHandle

Дескриптор сеанса клиента, возвращенный предыдущим вызовом функции WlanOpenHandle .

[in] OpCode

Идентификатор заданного свойства. Этот идентификатор может быть только следующими значениями в перечислении WLAN_HOSTED_NETWORK_OPCODE , определенном в файле заголовка Wlanapi.h :

wlan_hosted_network_opcode_connection_settings

Параметры подключения к размещенной сети.

wlan_hosted_network_opcode_enable

Флаг Hosted Network enabled (Включена размещенная сеть).

[in] dwDataSize

Значение типа , указывающее размер (в байтах) буфера, на который указывает параметр pvData .

[in] pvData

Указатель на буфер с заданным статическим свойством. Тип данных, связанный с этим буфером, зависит от значения параметра OpCode .

[out, optional] pFailReason

Необязательный указатель на значение, которое получает причину сбоя, если вызов функции WlanHostedNetworkSetProperty завершается сбоем. Возможные значения причины сбоя относятся к типу перечисления WLAN_HOSTED_NETWORK_REASON , определенному в файле заголовка Wlanapi.h .

pvReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.

Код возврата	Описание
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных разрешений. Эта ошибка также возвращается, если параметр OpCode был wlan_hosted_network_opcode_enable и беспроводная размещенная сеть отключена групповой политикой в домене.
ERROR_BAD_PROFILE	Профиль сетевого подключения, используемый беспроводной размещенной сетью, поврежден.
ERROR_INVALID_HANDLE	Недопустимый дескриптор. Эта ошибка возвращается, если дескриптор, указанный в параметре hClientHandle , не найден в таблице дескрипторов.
ERROR_INVALID_PARAMETER	Неправильный параметр. Эта ошибка возвращается при возникновении какого-либо из следующих условий: hClientHandle имеет значение NULL. OpCode не является одним из перечисленных значений, определенных в WLAN_HOSTED_NETWORK_OPCODE. DwDataSize равно нулю. pvData имеет значение NULL. PvData не указывает на правильно сформированное статическое свойство. pvReserved не имеет значения NULL.
ERROR_INVALID_STATE	Ресурс не находится в правильном состоянии для выполнения запрошенной операции. Это может произойти, если беспроводная размещенная сеть была в процессе завершения работы.
ERROR_NOT_SUPPORTED	Запрос не поддерживается. Эта ошибка возвращается, если приложение вызывает функцию WlanHostedNetworkSetProperty с параметром OpCode , равным wlan_hosted_network_opcode_station_profile или wlan_hosted_network_opcode_security_settings.
ERROR_SERVICE_NOT_ACTIVE	Служба не запущена. Эта ошибка возвращается, если служба автонастройки WLAN не запущена.
Другое	Различные коды RPC и другие коды ошибок. Используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки.

Функция WlanHostedNetworkSetProperty — это расширение собственных беспроводных API, добавленных для поддержки беспроводной размещенной сети в Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети.

Клиентское приложение вызывает функцию WlanHostedNetworkSetProperty , чтобы задать текущие статические свойства беспроводной размещенной сети. Любое изменение свойства Hosted Network, вызванное этой функцией, не будет автоматически отменено, если вызывающее приложение закрывает свой вызывающий дескриптор (путем вызова WlanCloseHandle с параметром hClientHandle ) или если процесс завершается.

Тип данных, связанный с буфером, на который указывает параметр pvData , зависит от значения параметра OpCode следующим образом:

OpCode	Описание
wlan_hosted_network_opcode_connection_settings	Указатель на структуру WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS передается в параметре pvData .
wlan_hosted_network_opcode_enable	Указатель на BOOL передается в параметре pvData .

Если функция WlanHostedNetworkSetProperty вызывается с параметром OpCode , равным wlan_hosted_network_opcode_enable, пользователь должен иметь соответствующие связанные привилегии. Разрешения хранятся в списке управления доступом на уровне пользователей (DACL), связанном с WLAN_SECURABLE_OBJECT. Чтобы вызвать функцию WlanHostedNetworkSetProperty с параметром OpCodewlan_hosted_network_opcode_enable, маркер клиентского доступа вызывающего объекта должен иметь повышенные привилегии, предоставляемые следующим перечислением в WLAN_SECURABLE_OBJECT:

wlan_secure_hosted_network_elevated_access

Если функции WlanHostedNetworkSetProperty передано одно из следующих значений в параметре OpCode , функция завершится ошибкой с ERROR_NOT_SUPPORTED:

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

Для успешного выполнения функции WlanHostedNetworkSetProperty необходимо сохранить новые параметры, которые требуют, чтобы состояние размещенной сети было переведено в wlan_hosted_network_idle если она запущена в данный момент (wlan_hosted_network_active).

Любой пользователь может вызвать эту функцию, чтобы задать свойства размещенной сети. Однако для установки флага wlan_hosted_network_opcode_enable требуются повышенные привилегии. Возможность включения беспроводной размещенной сети также может быть ограничена групповой политикой в домене.

В Windows 7 и более поздних версиях операционная система устанавливает виртуальное устройство, если на компьютере присутствует беспроводной адаптер с поддержкой размещенной сети. Это виртуальное устройство обычно отображается в папке "Сетевой Connections" как "Беспроводное сетевое подключение 2" с именем устройства "Microsoft Virtual WiFi Miniport adapter", если компьютер имеет один беспроводной сетевой адаптер. Это виртуальное устройство используется исключительно для выполнения подключений к точкам доступа программного обеспечения (SoftAP) и отсутствует в списке, возвращаемом функцией WlanEnumInterfaces . Время существования этого виртуального устройства привязано к физическому беспроводному адаптеру. Если физический беспроводной адаптер отключен, это виртуальное устройство также будет удалено. Эта функция также доступна в Windows Server 2008 R2 с установленной службой беспроводной локальной сети.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h (включая Wlanapi.h)
Библиотека	Wlanapi.lib
DLL	Wlanapi.dll