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

Статья
08/28/2023

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

Синтаксис

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

Параметры

[in] hClientHandle

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

[in] OpCode

Значение типа , указывающее параметр конфигурации для запроса.

Значение	Значение
wlan_autoconf_opcode_show_denied_networks	Если этот параметр задан, параметр ppData будет содержать значение BOOL , указывающее, будут ли сети, запрещенные пользователем и групповой политикой, включены в список доступных сетей. Если функция возвращает ERROR_SUCCESS, а ppData указывает на TRUE, то сети, запрещенные пользователем и групповой политикой, будут включены в список доступных сетей; Значение FALSE— сети, запрещенные пользователем и групповой политикой, не будут включены в список доступных сетей.
wlan_autoconf_opcode_power_setting	Если этот параметр задан, параметр ppData будет содержать значение WLAN_POWER_SETTING , указывающее параметры питания.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks	Если этот параметр задан, параметр ppData будет содержать значение BOOL , указывающее, можно ли использовать профили, не созданные групповой политикой, для подключения к разрешенной сети с соответствующим профилем групповой политики. Если функция возвращает ERROR_SUCCESS, а ppData указывает на TRUE, можно использовать только профили, созданные групповой политикой; Если значение FALSE, можно использовать любой профиль.
wlan_autoconf_opcode_allow_explicit_creds	Если этот параметр задан, параметр ppData будет содержать значение BOOL , указывающее, разрешены ли учетные данные общего пользователя в текущем беспроводном интерфейсе. Если функция возвращает ERROR_SUCCESS, а ppData указывает на TRUE, то в текущем беспроводном интерфейсе разрешены общие учетные данные пользователя; Значение FALSE означает, что текущий беспроводной интерфейс не разрешает общий доступ к учетным данным пользователя.
wlan_autoconf_opcode_block_period	Если этот параметр задан, параметр ppData будет содержать значение DWORD , указывающее значение периода блокировки для текущего беспроводного интерфейса. Период блокировки — это период времени в секундах, в течение которого автоматическое подключение к беспроводной сети не будет выполнено после предыдущего сбоя.
wlan_autoconf_opcode_allow_virtual_station_extensibility	Если этот параметр задан, параметр ppData будет содержать значение BOOL , указывающее, разрешена ли расширяемость на виртуальной станции. По умолчанию на виртуальной станции разрешена расширяемость. Значение этого кода операции сохраняется при перезапуске. Если функция возвращает ERROR_SUCCESS, а ppData указывает на TRUE, то расширяемость на виртуальной станции разрешена; Значение false, расширяемость на виртуальной станции не допускается.

pReserved

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

[out] pdwDataSize

Задает размер параметра ppData в байтах.

[out] ppData

Указатель на память, содержащую запрашиваемое значение для параметра, указанного в OpCode.

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

[out, optional] pWlanOpcodeValueType

Значение WLAN_OPCODE_VALUE_TYPE .

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

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

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

Код возврата	Описание
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных разрешений для получения параметров конфигурации. При вызове с параметромOpCode для wlan_autoconf_opcode_show_denied_networks WlanQueryAutoConfigParameter извлекает список управления доступом на уровне пользователей (DACL), хранящийся вместе с объектом wlan_secure_show_denied. Если DACL не содержит запись управления доступом (ACE), которая предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока, то WlanQueryAutoConfigParameter возвращает ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle имеет значение NULL или недопустимо, pReserved не равно NULL, ppData имеет значение NULL или pdwDataSize имеет значение NULL.
ERROR_INVALID_HANDLE	Дескриптор hClientHandle не найден в таблице дескрипторов.
ERROR_NOT_SUPPORTED	Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS	Различные коды ошибок.

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

Требования

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

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

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter

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