перечисление WLAN_SECURABLE_OBJECT (wlanapi.h)

Статья
08/28/2023

Перечислимый тип WLAN_SECURABLE_OBJECT определяет защищаемые объекты , используемые собственными функциями Wi-Fi.

Эти объекты можно защитить с помощью WlanSetSecuritySettings. Текущие разрешения, связанные с этими объектами, можно получить с помощью WlanGetSecuritySettings. Дополнительные сведения об использовании защищаемых объектов см. в разделе Управление доступом к объекту служб DACLs.

Синтаксис

typedef enum _WLAN_SECURABLE_OBJECT {
  wlan_secure_permit_list = 0,
  wlan_secure_deny_list,
  wlan_secure_ac_enabled,
  wlan_secure_bc_scan_enabled,
  wlan_secure_bss_type,
  wlan_secure_show_denied,
  wlan_secure_interface_properties,
  wlan_secure_ihv_control,
  wlan_secure_all_user_profiles_order,
  wlan_secure_add_new_all_user_profiles,
  wlan_secure_add_new_per_user_profiles,
  wlan_secure_media_streaming_mode_enabled,
  wlan_secure_current_operation_mode,
  wlan_secure_get_plaintext_key,
  wlan_secure_hosted_network_elevated_access,
  wlan_secure_virtual_station_extensibility,
  wlan_secure_wfd_elevated_access,
  WLAN_SECURABLE_OBJECT_COUNT
} WLAN_SECURABLE_OBJECT, *PWLAN_SECURABLE_OBJECT;

Константы


`wlan_secure_permit_list` Значение: 0 Разрешения на изменение списка разрешений для профилей пользователей. Списки управления доступом на уровне пользователей (DACL), связанные с этим защищаемым объектом, извлекаются при вызове WlanGetFilterList или WlanSetFilterList с параметром wlanFilterListType, для которого задано значение wlan_filter_list_type_user_permit. Чтобы вызов WlanGetFilterList завершился успешно, daCL должен содержать запись управления доступом (ACE), которая предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetFilterList daCL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_deny_list` Разрешения на изменение списка запретов для профилей пользователей. Служба автоматической настройки не установит подключение к сети в списке запретов. Список DACL, связанный с этим защищаемым объектом, извлекается при вызове WlanGetFilterList или WlanSetFilterList с параметром wlanFilterListType , для которого задано значение wlan_filter_list_type_user_deny. Для успешного вызова WlanGetFilterList daCL должен содержать ACE, предоставляющий WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetFilterList daCL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_ac_enabled` Разрешения для включения службы автоматической настройки. DaCL, связанный с этим защищаемым объектом, извлекается при вызове WlanQueryInterface или WlanSetInterface с opCode , для которого задано значение wlan_intf_opcode_autoconf_enabled. Для успешного вызова WlanQueryInterface DACL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetInterface daCL должен содержать ACE, предоставляющий WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_bc_scan_enabled` Разрешения для включения фонового сканирования. Список DACL, связанный с этим защищаемым объектом, извлекается при вызове WlanQueryInterface или WlanSetInterface с opCode , для которого задано значение wlan_intf_opcode_background_scan_enabled. Для успешного вызова WlanQueryInterface DACL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetInterface daCL должен содержать ACE, предоставляющий WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_bss_type` Разрешения для изменения базового типа набора служб. Список DACL, связанный с этим защищаемым объектом, извлекается при вызове WlanQueryInterface или WlanSetInterface с opCode , для которого задано значение wlan_intf_opcode_bss_type. Для успешного вызова WlanQueryInterface DACL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetInterface daCL должен содержать ACE, предоставляющий WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_show_denied` Разрешения для изменения того, отображаются ли сети в списке запрещенных сетей в списке доступных сетей. DaCL, связанный с этим защищаемым объектом, извлекается при вызове WlanQueryAutoConfigParameter или WlanSetAutoConfigParameter с opCode , для которого задано значение wlan_autoconf_opcode_show_denied_networks. Для успешного вызова WlanQueryAutoConfigParameter daCL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetAutoConfigParameter daCL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_interface_properties` Разрешения для изменения свойств интерфейса. Это универсальный защищаемый объект, используемый WlanQueryInterface или WlanSetInterface , если не используется другой более конкретный защищаемый объект. Его DACL извлекается всякий раз, когда WlanQueryInterface или WlanSetInterface является маркером доступа вызывающего потока, а opCode имеет значение, отличное от wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled, wlan_intf_opcode_media_streaming_mode, wlan_intf_opcode_bss_type или wlan_intf_opcode_current_operation_mode. DaCL также не извлекается, если для OpCode задано значение wlan_intf_opcode_radio_state а вызывающий объект является пользователем консоли. Для успешного вызова WlanQueryInterface DACL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetInterface daCL должен содержать ACE, предоставляющий WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_ihv_control` Разрешения на использование функции WlanIhvControl для контроля независимых поставщиков оборудования (IHV) драйверов или служб WLAN. Список DACL, связанный с этим защищаемым объектом, извлекается при вызове WlanIhvControl . Для успешного вызова DACL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_all_user_profiles_order` Разрешения на изменение порядка профилей всех пользователей. DaCL, связанный с этим защищаемым объектом, извлекается до того, как WlanSetProfileList или WlanSetProfilePosition выполнит операцию, которая изменяет относительный порядок профилей всех пользователей в списке профилей или перемещает профиль всех пользователей на более низкую позицию в списке профилей. Для успешного вызова daCL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_add_new_all_user_profiles` Разрешения для добавления новых профилей всех пользователей. Примечание Дескриптор безопасности, связанный с этим объектом, применяется к новым созданным профилям всех пользователей. DaCL, связанный с этим защищаемым объектом, извлекается при вызове WlanSetProfile с параметром dwFlags , для которого задано значение 0. Для успешного вызова DACL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_add_new_per_user_profiles` Разрешения для добавления новых профилей для каждого пользователя. DaCL, связанный с этим защищаемым объектом, извлекается при вызове WlanSetProfile с параметром dwFlags , для которого задано значение WLAN_PROFILE_USER. Для успешного вызова DACL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_media_streaming_mode_enabled` Разрешения для настройки или запроса режима потоковой передачи мультимедиа. DaCL, связанный с этим защищаемым объектом, извлекается при вызове WlanQueryInterface или WlanSetInterface с opCode , для которого задано значение wlan_intf_opcode_media_streaming_mode. Для успешного вызова WlanQueryInterface DACL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetInterface daCL должен содержать ACE, предоставляющий WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_current_operation_mode` Разрешения для настройки или запроса режима работы беспроводного интерфейса. DaCL, связанный с этим защищаемым объектом, извлекается при вызове WlanQueryInterface или WlanSetInterface с opCode , для которого задано значение wlan_intf_opcode_current_operation_mode. Для успешного вызова WlanQueryInterface DACL должен содержать ACE, который предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. Для успешного вызова WlanSetInterface daCL должен содержать ACE, предоставляющий WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока.
`wlan_secure_get_plaintext_key` Разрешения на получение открытого текстового ключа из беспроводного профиля. DaCL, связанный с этим защищаемым объектом, извлекается при вызове функции WlanGetProfile с флагом WLAN_PROFILE_GET_PLAINTEXT_KEY , установленным в значении, на которое указывает параметр pdwFlags на входных данных. Для успешного вызова WlanGetProfile daCL должен содержать ACE, предоставляющий WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока. По умолчанию разрешения на получение открытого текстового ключа разрешены только членам группы "Администраторы" на локальном компьютере. Windows 7: Это значение является расширением собственных беспроводных API, добавленных в Windows 7 и более поздних версий.
`wlan_secure_hosted_network_elevated_access` Разрешения с повышенным уровнем доступа для вызова привилегированных функций размещенной сети. Список DACL, связанный с этим защищаемым объектом, извлекается при вызове функции WlanHostedNetworkSetProperty с параметром OpCode , для которого задано значение wlan_hosted_network_opcode_enable. Для успешного вызова WlanHostedNetworkSetProperty DACL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока. По умолчанию разрешение на присвоение свойству беспроводной размещенной сети wlan_hosted_network_opcode_enable предоставляется только членам группы "Администраторы" на локальном компьютере. Список DACL, связанный с этим защищаемым объектом, извлекается при вызове функции WlanHostedNetworkForceStart . Для успешного вызова WlanHostedNetworkForceStart daCL должен содержать ACE, который предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока. По умолчанию разрешение на принудительное запуск беспроводной размещенной сети предоставляется только членам группы "Администраторы" на локальном компьютере. Windows 7: Это значение является расширением собственных беспроводных API, добавленных в Windows 7 и более поздних версий.
`wlan_secure_virtual_station_extensibility` Windows 7: Это значение является расширением собственных беспроводных API, добавленных в Windows 7 и более поздних версий.
`wlan_secure_wfd_elevated_access` Это значение зарезервировано для внутреннего использования службой Wi-Fi Direct. Windows 8: Это значение является расширением собственных беспроводных API, добавленных в Windows 8 и более поздних версий.
`WLAN_SECURABLE_OBJECT_COUNT`

Эти объекты можно защитить с помощью WlanSetSecuritySettings. Текущие разрешения, связанные с этими объектами, можно получить с помощью WlanGetSecuritySettings. Дополнительные сведения об использовании защищаемых объектов см. в разделах Управление доступом к объекту списков DACLs и Собственные разрешения API Wi-Fi.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	wlanapi.h