Функция WlanSetInterface (wlanapi.h)
Функция 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. Используйте таблицу выше, чтобы определить тип используемых данных.
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) |