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

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

  • Статья

Функция 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