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


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

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

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

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

Требования

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

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

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

WlanGetSecuritySettings