Функция WlanSetAutoConfigParameter (wlanapi.h)
Функция 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 поддерживают операции набора.
[in] dwDataSize
Размер параметра pData в байтах. Этот параметр должен иметь значение sizeof(BOOL)
для BOOL или sizeof(DWORD)
DWORD в зависимости от значения параметра OpCode .
[in] pData
Значение, устанавливаемое для параметра, указанного в параметре OpCode . Параметр pData должен указывать на логическое значение или значение DWORD в зависимости от значения параметра OpCode . Параметр pData не должен иметь значение NULL.
pReserved
Зарезервировано для последующего использования. Необходимо задать значение NULL.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.
Код возврата | Описание |
---|---|
|
Отказано в доступе". Эта ошибка возвращается, если вызывающий объект не имеет достаточных разрешений для задания параметра конфигурации, если параметр 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 |
|
Недопустимый параметр. Эта ошибка возвращается, если параметр hClientHandle имеет значение NULL, параметр pData имеет значение NULL или параметр pReserved не равен NULL. Эта ошибка также возвращается, если указанный параметр OpCode не является одним из WLAN_AUTOCONF_OPCODE значений для параметра конфигурации, который можно задать. Эта ошибка также возвращается, если параметру dwDataSize не задано значение sizeof(BOOL) или dwDataSize не задано значение sizeof(BOOL) в зависимости от значения параметра OpCode .
|
|
Дескриптор hClientHandle не найден в таблице дескрипторов. |
|
Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2). |
|
Различные коды ошибок. |
Комментарии
Функция 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 |