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

Статья
08/28/2023

Функция WlanGetSecuritySettings получает параметры безопасности, связанные с настраиваемым объектом.

Синтаксис

DWORD WlanGetSecuritySettings(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_SECURABLE_OBJECT   SecurableObject,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pValueType,
  [out]           LPWSTR                  *pstrCurrentSDDL,
  [out]           PDWORD                  pdwGrantedAccess
);

Параметры

[in] hClientHandle

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

[in] SecurableObject

Значение WLAN_SECURABLE_OBJECT , указывающее объект, к которому применяются параметры безопасности.

[out, optional] pValueType

Указатель на значение WLAN_OPCODE_VALUE_TYPE , указывающее источник параметров безопасности.

Значение	Значение
wlan_opcode_value_type_set_by_group_policy	Параметры безопасности были заданы групповой политикой.
wlan_opcode_value_type_set_by_user	Параметры безопасности были заданы пользователем. Пользователь может задать параметры безопасности, вызвав WlanSetSecuritySettings.

[out] pstrCurrentSDDL

Для входных данных этот параметр должен иметь значение NULL.

В выходных данных этот параметр получает указатель на строку дескриптора безопасности, которая указывает параметры безопасности для объекта в случае успешного вызова функции. Дополнительные сведения об этой строке см. в разделе Функция WlanSetSecuritySettings .

[out] pdwGrantedAccess

Маска доступа объекта.

Значение	Значение
WLAN_READ_ACCESS	Вызывающий объект может просматривать разрешения объекта.
WLAN_EXECUTE_ACCESS	Вызывающий объект может считывать и выполнять объект . WLAN_EXECUTE_ACCESS имеет то же значение, что и побитовое сочетание ИЛИ WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS	Вызывающий объект может считывать, выполнять и записывать данные в объект . WLAN_WRITE_ACCESS имеет то же значение, что и побитовое сочетание ИЛИ WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS \| WLAN_WRITE_ACCESS.

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Неправильный параметр. Эта ошибка возвращается при возникновении любого из следующих условий: hClientHandle имеет значение NULL. pstrCurrentSDDL имеет значение NULL. PdwGrantedAccess имеет значение NULL. Параметр SecurableObject имеет значение, большее или равное WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE	Недопустимый дескриптор. Эта ошибка возвращается, если дескриптор, указанный в параметре hClientHandle , не найден в таблице дескрипторов.
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных разрешений.
ERROR_NOT_SUPPORTED	Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).

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

Требования

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

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

Собственные разрешения API Wi-Fi

WlanFreeMemory

WlanSetSecuritySettings

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