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

Статья
08/28/2023

Функция WlanSetAutoConfigParameter задает параметры для службы автоматической настройки.

Синтаксис

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

Параметры

[in] hClientHandle

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

[in] OpCode

Значение WLAN_AUTOCONF_OPCODE , указывающее заданный параметр. Только некоторые из кодов операций в перечислении WLAN_AUTOCONF_OPCODE поддерживают операции набора.

Значение	Значение
wlan_autoconf_opcode_show_denied_networks	Если этот параметр задан, параметр pData будет содержать значение BOOL , указывающее, будут ли сети, запрещенные пользователем и групповой политикой, включены в список доступных сетей.
wlan_autoconf_opcode_allow_explicit_creds	Если этот параметр задан, параметр pData будет содержать значение BOOL , указывающее, разрешены ли учетные данные общего пользователя в текущем беспроводном интерфейсе.
wlan_autoconf_opcode_block_period	Если этот параметр задан, параметр pData будет содержать значение DWORD для параметра периода блокировки для текущего беспроводного интерфейса. Период блокировки — это период времени в секундах, в течение которого автоматическое подключение к беспроводной сети не будет выполнено после предыдущего сбоя.
wlan_autoconf_opcode_allow_virtual_station_extensibility	Если этот параметр задан, параметр pData будет содержать значение BOOL , указывающее, разрешена ли расширяемость виртуальной станции. По умолчанию на виртуальной станции разрешена расширяемость. Значение этого кода операции сохраняется при перезапуске. Это значение перечисления поддерживается в Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети.

[in] dwDataSize

Размер параметра pData в байтах. Этот параметр должен иметь значение sizeof(BOOL) для BOOL или sizeof(DWORD) DWORD в зависимости от значения параметра OpCode .

[in] pData

Значение, устанавливаемое для параметра, указанного в параметре OpCode . Параметр pData должен указывать на логическое значение или значение DWORD в зависимости от значения параметра OpCode . Параметр pData не должен иметь значение NULL.

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

pReserved

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

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

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

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

Код возврата	Описание
ERROR_ACCESS_DENIED	Отказано в доступе". Эта ошибка возвращается, если вызывающий объект не имеет достаточных разрешений для задания параметра конфигурации, если параметр OpCode wlan_autoconf_opcode_show_denied_networks или wlan_autoconf_opcode_allow_virtual_station_extensibility. Если для параметра OpCode задано одно из этих значений, функция WlanSetAutoConfigParameter извлекает список управления доступом (DACL), хранящийся для объекта opcode. Если DACL не содержит запись управления доступом (ACE), которая предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока, WlanSetAutoConfigParameter возвращает ERROR_ACCESS_DENIED. Эта ошибка также возвращается, если параметр конфигурации задан групповой политикой для домена. Если для кода операции задана групповая политика, приложения не могут вносить изменения. Для следующих параметров OpCode можно задать с помощью групповой политики: wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds и wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER	Недопустимый параметр. Эта ошибка возвращается, если параметр hClientHandle имеет значение NULL, параметр pData имеет значение NULL или параметр pReserved не равен NULL. Эта ошибка также возвращается, если указанный параметр OpCode не является одним из WLAN_AUTOCONF_OPCODE значений для параметра конфигурации, который можно задать. Эта ошибка также возвращается, если параметру dwDataSize не задано значение `sizeof(BOOL)`или dwDataSize не задано значение `sizeof(BOOL)` в зависимости от значения параметра OpCode .
ERROR_INVALID_HANDLE	Дескриптор hClientHandle не найден в таблице дескрипторов.
ERROR_NOT_SUPPORTED	Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS	Различные коды ошибок.

Функция WlanSetAutoConfigParameter задает параметры, используемые модулем автоматической настройки (ACM), компонентом беспроводной конфигурации, поддерживаемым в Windows Vista и более поздних версий.

В зависимости от значения параметра OpCode данные, на которые указывает pData , будут преобразованы в логическое значение до установки параметра автоматической конфигурации. Если pData указывает на 0, то параметру присваивается значение FALSE; В противном случае параметру присваивается значение TRUE.

Требования

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

См. также раздел

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter

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