WLAN_SECURABLE_OBJECT wlanapi.h (列舉)

發行項
03/08/2023

WLAN_SECURABLE_OBJECT列舉類型會定義Native Wifi Functions所使用的安全性實體物件。

您可以使用 WlanSetSecuritySettings來保護這些物件。您可以使用 WlanGetSecuritySettings來擷取與這些物件相關聯的目前許可權。如需使用安全性實體物件的詳細資訊，請參閱 DACLs 如何控制對物件的存取。

Syntax

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 或 WlanSetFilterwlan_filter_list_type_user_permit List 呼叫WlanFilterList時，會擷取與這個安全性實體物件相關聯的DACL (DACL) 。若要讓 WlanGetFilterList 呼叫成功，DACL 必須包含存取控制專案 (ACE) ，以授與呼叫執行緒之存取權杖 WLAN_READ_ACCESS許可權。若要讓 WlanSetFilterList 呼叫成功，DACL 必須包含 ACE，該 ACE 會將WLAN_WRITE_ACCESS許可權授與呼叫執行緒的存取權杖。
`wlan_secure_deny_list` 修改使用者設定檔拒絕清單的許可權。自動設定服務不會在拒絕清單上建立與網路的連線。當WlanGetFilterList 或 WlanSetFilterList呼叫 wlanFilterList 時，會擷取與此安全性實體物件相關聯的 DACL，並將wlanFilterListType設定為wlan_filter_list_type_user_deny。若要讓 WlanGetFilterList 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetFilterList 呼叫成功，DACL 必須包含 ACE，該 ACE 會將WLAN_WRITE_ACCESS許可權授與呼叫執行緒的存取權杖。
`wlan_secure_ac_enabled` 啟用自動設定服務的許可權。當 WlanQueryInterface 或 WlanSetInterface 呼叫時，會擷取與此安全性實體物件相關聯的 DACL，並將 OpCode 設定為 wlan_intf_opcode_autoconf_enabled。若要讓 WlanQueryInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_bc_scan_enabled` 啟用背景掃描的許可權。當 WlanQueryInterface 或 WlanSetInterface 呼叫時，會擷取與此安全性實體物件相關聯的 DACL，並將 OpCode 設定為 wlan_intf_opcode_background_scan_enabled。若要讓 WlanQueryInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_bss_type` 變更基本服務集類型的許可權。當 WlanQueryInterface 或 WlanSetInterface 呼叫時，會擷取與此安全性實體物件相關聯的 DACL，並將 OpCode 設定為 wlan_intf_opcode_bss_type。若要讓 WlanQueryInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_show_denied` 修改拒絕清單上的網路是否出現在可用的網路清單中的許可權。當 WlanQueryAutoConfigParameter 或 WlanSetAutoConfigParameter 呼叫時，會擷取與此安全性實體物件相關聯的 DACL，並將 OpCode 設定為 wlan_autoconf_opcode_show_denied_networks。若要讓 WlanQueryAutoConfigParameter 呼叫成功，DACL 必須包含 ACE，該 ACE 會授與呼叫執行緒的存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetAutoConfigParameter 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`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，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_ihv_control` 獨立硬體廠商使用 WlanIhvControl 函式的許可權， (IHV) WLAN 驅動程式或服務的控制。呼叫 WlanIhvControl 時，會擷取與此安全性實體物件相關聯的 DACL。若要讓呼叫成功，DACL 必須包含 ACE，該 ACE 會授與呼叫執行緒之存取權杖的WLAN_WRITE_ACCESS許可權。
`wlan_secure_all_user_profiles_order` 修改所有使用者設定檔順序的許可權。在 WlanSetProfileList 或 WlanSetProfilePosition 之前擷取與此安全性實體物件相關聯的 DACL 會執行一項作業，以變更配置檔案清單中所有使用者設定檔的相對順序，或將所有使用者設定檔移至配置檔案清單中的較低位置。若要讓任一個呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_add_new_all_user_profiles` 新增所有使用者設定檔的許可權。注意與此物件相關聯的安全描述項會套用至新建立的所有使用者設定檔。當使用dwFlags設定為 0 呼叫WlanSetProfile時，會擷取與此安全性實體物件相關聯的 DACL。若要讓呼叫成功，DACL 必須包含 ACE，該 ACE 會授與呼叫執行緒之存取權杖的WLAN_WRITE_ACCESS許可權。
`wlan_secure_add_new_per_user_profiles` 新增個別使用者設定檔的許可權。當使用dwFlags設為 WLAN_PROFILE_USER 呼叫WlanSetProfile時，會擷取與此安全性實體物件相關聯的 DACL。若要讓呼叫成功，DACL 必須包含 ACE，該 ACE 會授與呼叫執行緒之存取權杖的WLAN_WRITE_ACCESS許可權。
`wlan_secure_media_streaming_mode_enabled` 設定或查詢媒體串流模式的許可權。當 WlanQueryInterface 或 WlanSetInterface 呼叫時，會擷取與此安全性實體物件相關聯的 DACL，並將 OpCode 設定為 wlan_intf_opcode_media_streaming_mode。若要讓 WlanQueryInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_current_operation_mode` 設定或查詢無線介面作業模式的許可權。當 WlanQueryInterface 或 WlanSetInterface 呼叫時，會擷取與此安全性實體物件相關聯的 DACL，並將 OpCode 設定為 wlan_intf_opcode_current_operation_mode。若要讓 WlanQueryInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_READ_ACCESS許可權。若要讓 WlanSetInterface 呼叫成功，DACL 必須包含 ACE，以授與呼叫執行緒存取權杖WLAN_WRITE_ACCESS許可權。
`wlan_secure_get_plaintext_key` 從無線設定檔擷取純文字金鑰的許可權。呼叫WlanGetProfile函式時，會擷取與此安全性實體物件相關聯的 DACL，並在輸入上的pdwFlags參數所指向的值中設定WLAN_PROFILE_GET_PLAINTEXT_KEY旗標。若要讓 WlanGetProfile 呼叫成功，DACL 必須包含 ACE，該 ACE 會授與呼叫執行緒之存取權杖的WLAN_READ_ACCESS 許可權。根據預設，只允許擷取純文字金鑰的許可權給本機電腦上的 Administrators 群組成員。 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許可權。根據預設，只有本機電腦上的 Administrators 群組成員才允許將無線託管網路屬性設定為 wlan_hosted_network_opcode_enable 的許可權。呼叫 WlanHostedNetworkForceStart 函式時，會擷取與此安全性實體物件相關聯的 DACL。若要讓 WlanHostedNetworkForceStart 呼叫成功，DACL 必須包含 ACE，該 ACE 會授與呼叫執行緒的存取權杖 WLAN_WRITE_ACCESS 許可權。根據預設，強制啟動無線託管網路的許可權只允許本機電腦上的 Administrators 群組成員使用。 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來擷取與這些物件相關聯的目前許可權。如需使用安全性實體物件的詳細資訊，請參閱 DACLs 如何控制對物件的存取和原生 Wifi API 許可權。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	wlanapi.h