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

Статья
08/28/2023

Функция WlanSetInterface задает настраиваемые пользователем параметры для указанного интерфейса.

Синтаксис

DWORD WlanSetInterface(
  [in] HANDLE           hClientHandle,
  [in] const GUID       *pInterfaceGuid,
  [in] WLAN_INTF_OPCODE OpCode,
  [in] DWORD            dwDataSize,
  [in] const PVOID      pData,
       PVOID            pReserved
);

Параметры

[in] hClientHandle

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

[in] pInterfaceGuid

GUID настраиваемого интерфейса.

[in] OpCode

Значение WLAN_INTF_OPCODE , указывающее заданный параметр. В следующей таблице перечислены допустимые константы, а также тип данных параметра в pData.

значение WLAN_INTF_OPCODE	Тип данных pData	Описание
wlan_intf_opcode_autoconf_enabled	BOOL	Включает или отключает автоматическую настройку для указанного интерфейса.
wlan_intf_opcode_background_scan_enabled	BOOL	Включает или отключает фоновую проверку для указанного интерфейса.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	Задает состояние программного радио для определенного физического уровня (PHY) для интерфейса.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	Задает тип BSS.
wlan_intf_opcode_media_streaming_mode	BOOL	Задает режим потоковой передачи мультимедиа для драйвера.
wlan_intf_opcode_current_operation_mode	ULONG	Задает текущий режим работы для интерфейса. Дополнительные сведения см. в подразделе "Примечания".

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Допустимы только константы wlan_intf_opcode_autoconf_enabled и wlan_intf_opcode_bss_type .

[in] dwDataSize

Размер параметра pData в байтах. Если dwDataSize больше фактического объема памяти, выделенной для pData, в вызывающей программе произойдет нарушение доступа.

[in] pData

Значение, заданное параметром OpCode . Тип данных, на которые указывает pData, должен соответствовать указанному коду OpCode. Используйте таблицу выше, чтобы определить тип используемых данных.

Примечание Если для OpCode задано значение wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled или wlan_intf_opcode_media_streaming_mode, pData может указывать на целочисленное значение. Если pData указывает на 0, значение преобразуется в FALSE. Если pData указывает на ненулевое целое число, значение преобразуется в TRUE.

pReserved

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

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

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

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

Если для OpCode задано значение wlan_intf_opcode_current_operation_mode, функция WlanSetInterface задает текущий режим работы беспроводного интерфейса. Дополнительные сведения о режимах работы см. в разделе Собственные режимы работы 802.11. Поддерживаются два режима работы: DOT11_OPERATION_MODE_EXTENSIBLE_STATION и DOT11_OPERATION_MODE_NETWORK_MONITOR. Константы режима работы определяются в файле заголовка Windot11.h. Если pData не указывает на одно из этих значений, если для OpCode задано значение wlan_intf_opcode_current_operation_mode, функция WlanSetInterface завершится ошибкой.

Чтобы включить или отключить службу автоматической настройки в командной строке, которая функционально эквивалентна вызову WlanSetInterface с wlan_intf_opcode_autoconf_enabled OpCode, используйте команду netsh wlan setautoconfig. Дополнительные сведения см. в разделе Команды Netsh для беспроводной локальной сети (wlan).

Состояние программного радиосвязи можно изменить, вызвав функцию WlanSetInterface . Состояние аппаратного радиосвязи нельзя изменить путем вызова функции WlanSetInterface . Если параметру OpCode присвоено значение wlan_intf_opcode_radio_state, функция WlanSetInterface задает состояние программного радиосвязи определенного PHY. Параметр pData должен указывать на структуру WLAN_PHY_RADIO_STATE с новыми значениями состояния радиосвязи. Элемент dot11HardwareRadioState структуры WLAN_PHY_RADIO_STATE игнорируется при вызове функции WlanSetInterface с параметром OpCode , равным wlan_intf_opcode_radio_state , а параметр pData указывает на WLAN_PHY_RADIO_STATE структуру. Состояние радиосвязи PHY отключено, если состояние программного радиосвязи (элемент dot11SoftwareRadioStateструктуры WLAN_PHY_RADIO_STATE ) или аппаратное состояние радиосвязи (элемент dot11HardwareRadioStateструктуры WLAN_PHY_RADIO_STATE ).

Изменение состояния передачи программного обеспечения физического сетевого интерфейса может привести к соответствующим изменениям состояния беспроводной размещенной сети или состояния радиомодулов виртуального беспроводного адаптера. PhY каждого виртуального беспроводного адаптера связаны. Дополнительные сведения см. в разделе Сведения о беспроводной размещенной сети.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h (включая Wlanapi.h)
Библиотека	Wlanapi.lib
DLL	Wlanapi.dll
Распространяемые компоненты	API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)