WLAN_SECURABLE_OBJECT枚举 (wlanapi.h)

项目
08/28/2023

WLAN_SECURABLE_OBJECT枚举类型定义 Native Wifi Functions 使用的安全对象。

可以使用 WlanSetSecuritySettings 保护这些对象。可以使用 WlanGetSecuritySettings 检索与这些对象关联的当前权限。有关使用安全对象的详细信息，请参阅 DACL 如何控制对对象的访问。

语法

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 修改用户配置文件的允许列表的权限。调用 wlanGetFilterList 或 WlanSetFilterList 且 wlanFilterListType 设置为 wlan_filter_list_type_user_permit 时，会检索与此安全对象关联的 DACL (DACL) 自由访问控制列表。若要使 WlanGetFilterList 调用成功，DACL 必须包含一个访问控制项 (ACE) ，该条目向调用线程的访问令牌授予WLAN_READ_ACCESS权限。要使 WlanSetFilterList 调用成功，DACL 必须包含向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限的 ACE。
`wlan_secure_deny_list` 修改用户配置文件的拒绝列表的权限。自动配置服务不会与拒绝列表中的网络建立连接。当调用 WlanGetFilterListListType 设置为 wlan_filter_list_type_user_deny时，将调用 WlanGetFilterList 或 WlanSetFilterList 时，将检索与此安全对象关联的 DACL。若要使 WlanGetFilterList 调用成功，DACL 必须包含向调用线程的访问令牌授予WLAN_READ_ACCESS权限的 ACE。要使 WlanSetFilterList 调用成功，DACL 必须包含向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限的 ACE。
`wlan_secure_ac_enabled` 启用自动配置服务的权限。调用 WlanQueryInterface 或 WlanSetInterface 且 OpCode 设置为 wlan_intf_opcode_autoconf_enabled 时，将检索与此安全对象关联的 DACL。要使 WlanQueryInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_READ_ACCESS权限。要使 WlanSetInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限。
`wlan_secure_bc_scan_enabled` 启用后台扫描的权限。调用 WlanQueryInterface 或 WlanSetInterface 且 OpCode 设置为 wlan_intf_opcode_background_scan_enabled 时，将检索与此安全对象关联的 DACL。要使 WlanQueryInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_READ_ACCESS权限。要使 WlanSetInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限。
`wlan_secure_bss_type` 用于更改基本服务集类型的权限。调用 WlanQueryInterface 或 WlanSetInterface 且 OpCode 设置为 wlan_intf_opcode_bss_type 时，将检索与此安全对象关联的 DACL。要使 WlanQueryInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_READ_ACCESS权限。要使 WlanSetInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限。
`wlan_secure_show_denied` 用于修改拒绝列表中的网络是否显示在可用网络列表中的权限。当调用 WlanQueryAutoConfigParameter 或 WlanSetAutoConfigParameter 且 OpCode 设置为 wlan_autoconf_opcode_show_denied_networks 时，将检索与此安全对象关联的 DACL。若要使 WlanQueryAutoConfigParameter 调用成功，DACL 必须包含向调用线程的访问令牌授予WLAN_READ_ACCESS权限的 ACE。若要使 WlanSetAutoConfigParameter 调用成功，DACL 必须包含向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限的 ACE。
`wlan_secure_interface_properties` 更改接口属性的权限。当未使用其他更具体的安全对象时，这是 WlanQueryInterface 或 WlanSetInterface 使用的通用安全对象。只要 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 并且调用方是控制台用户时，也不会检索 DACL。要使 WlanQueryInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_READ_ACCESS权限。要使 WlanSetInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限。
`wlan_secure_ihv_control` 对独立硬件供应商使用 WlanIhvControl 函数的权限 (IHV) WLAN 驱动程序或服务的控制。调用 WlanIhvControl 时，将检索与此安全对象关联的 DACL。要使调用成功，DACL 必须包含向WLAN_WRITE_ACCESS授予调用线程访问令牌权限的 ACE。
`wlan_secure_all_user_profiles_order` 用于修改所有用户配置文件顺序的权限。在 WlanSetProfileList 或 WlanSetProfilePosition 执行更改配置文件列表中所有用户配置文件的相对顺序或将全用户配置文件移动到配置文件列表中的较低位置的操作之前，将检索与此安全对象关联的 DACL。若要使任一调用成功，DACL 必须包含向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限的 ACE。
`wlan_secure_add_new_all_user_profiles` 用于添加新的所有用户配置文件的权限。注意与此对象关联的安全描述符将应用于创建的新所有用户配置文件。当将 dwFlags 设置为 0 的情况下调用 WlanSetProfile 时，将检索与此安全对象关联的 DACL。要使调用成功，DACL 必须包含向WLAN_WRITE_ACCESS授予调用线程访问令牌权限的 ACE。
`wlan_secure_add_new_per_user_profiles` 用于添加新的按用户配置文件的权限。调用 WlanSetProfile 并将 dwFlags 设置为 WLAN_PROFILE_USER 时，将检索与此安全对象关联的 DACL。要使调用成功，DACL 必须包含向WLAN_WRITE_ACCESS授予调用线程访问令牌权限的 ACE。
`wlan_secure_media_streaming_mode_enabled` 设置或查询媒体流模式的权限。调用 WlanQueryInterface 或 WlanSetInterface 且 OpCode 设置为 wlan_intf_opcode_media_streaming_mode 时，将检索与此安全对象关联的 DACL。要使 WlanQueryInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_READ_ACCESS权限。要使 WlanSetInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限。
`wlan_secure_current_operation_mode` 用于设置或查询无线接口的操作模式的权限。调用 WlanQueryInterface 或 WlanSetInterface 且 OpCode 设置为 wlan_intf_opcode_current_operation_mode 时，将检索与此安全对象关联的 DACL。要使 WlanQueryInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_READ_ACCESS权限。要使 WlanSetInterface 调用成功，DACL 必须包含一个 ACE，该 ACE 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限。
`wlan_secure_get_plaintext_key` 从无线配置文件中检索纯文本密钥的权限。调用 WlanGetProfile 函数时，在输入时 pdwFlags 参数指向的值中设置了 WLAN_PROFILE_GET_PLAINTEXT_KEY 标志时，将检索与此安全对象关联的 DACL。要使 WlanGetProfile 调用成功，DACL 必须包含向调用线程的访问令牌授予 WLAN_READ_ACCESS 权限的 ACE。默认情况下，仅允许本地计算机上的管理员组成员具有检索纯文本密钥的权限。 Windows 7：此值是 Windows 7 及更高版本上添加的本机无线 API 的扩展。
`wlan_secure_hosted_network_elevated_access` 具有调用特权托管网络函数的提升访问权限的权限。如果调用 WlanHostedNetworkSetProperty 函数，并将 OpCode 参数设置为 wlan_hosted_network_opcode_enable，则会检索与此安全对象关联的 DACL。若要使 WlanHostedNetworkSetProperty 调用成功，DACL 必须包含一个 ACE，该 ACE 向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限。默认情况下，仅本地计算机上的管理员组成员允许将无线托管网络属性设置为 wlan_hosted_network_opcode_enable 的权限。调用 WlanHostedNetworkForceStart 函数时，将检索与此安全对象关联的 DACL。要使 WlanHostedNetworkForceStart 调用成功，DACL 必须包含向调用线程的访问令牌授予 WLAN_WRITE_ACCESS 权限的 ACE。默认情况下，只有本地计算机上的管理员组的成员才有权强制启动无线托管网络。 Windows 7：此值是 Windows 7 及更高版本上添加的本机无线 API 的扩展。
`wlan_secure_virtual_station_extensibility` Windows 7：此值是 Windows 7 及更高版本上添加的本机无线 API 的扩展。
`wlan_secure_wfd_elevated_access` 此值由 Wi-Fi Direct 服务保留供内部使用。 Windows 8：此值是 Windows 8 及更高版本上添加的本机无线 API 的扩展。
`WLAN_SECURABLE_OBJECT_COUNT`

注解

可以使用 WlanSetSecuritySettings 保护这些对象。可以使用 WlanGetSecuritySettings 检索与这些对象关联的当前权限。有关使用安全对象的详细信息，请参阅 DACL 如何控制对对象的访问和本机 Wifi API 权限。

要求


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	wlanapi.h