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

Статья
08/28/2023

Функция WlanGetProfileList задает параметры безопасности для настраиваемого объекта.

Синтаксис

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

Параметры

[in] hClientHandle

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

[in] SecurableObject

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

[in] strModifiedSDDL

Строка дескриптора безопасности, указывающая новые параметры безопасности для объекта . Эта строка должна заканчиваться значением NULL. Дополнительные сведения см. в разделе «Примечания».

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Неправильный параметр. Эта ошибка возвращается при возникновении любого из следующих условий: hClientHandle имеет значение NULL. StrModifiedSDDL имеет значение 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).

Успешный вызов функции WlanSetSecuritySettings переопределяет разрешения по умолчанию, связанные с объектом . Дополнительные сведения о разрешениях по умолчанию см. в разделе Разрешения API Native Wifi.

Ниже описана процедура создания объекта дескриптора безопасности и его анализа в виде строки.

Вызовите InitializeSecurityDescriptor , чтобы создать дескриптор безопасности в памяти.
Вызовите Метод SetSecurityDescriptorOwner , чтобы задать сведения о владельце дескриптора безопасности.
Вызовите Метод InitializeAcl , чтобы создать список управления доступом на уровне пользователей (DACL) в памяти.
Вызовите метод AddAccessAllowedAce или AddAccessDeniedAce , чтобы добавить записи управления доступом (ACE) в DACL. Задайте для параметра AccessMask одно из следующих побитовых сочетаний OR соответствующим образом:
- WLAN_READ_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
Вызовите Метод SetSecurityDescriptorDacl , чтобы добавить DACL в дескриптор безопасности.
Вызовите Метод ConvertSecurityDescriptorToStringSecurityDescriptor для преобразования дескриптора в строку.

Строка, возвращаемая ConvertSecurityDescriptorToStringSecurityDescriptor , затем может использоваться в качестве значения параметра strModifiedSDDL при вызове WlanSetSecuritySettings.

Требования


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

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

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

WlanGetSecuritySettings

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