enumerazione WLAN_SECURABLE_OBJECT (wlanapi.h)

Articolo
08/28/2023

Il tipo enumerato WLAN_SECURABLE_OBJECT definisce gli oggetti a protezione diretta usati da Native Wifi Functions.

Questi oggetti possono essere protetti usando WlanSetSecuritySettings. Le autorizzazioni correnti associate a questi oggetti possono essere recuperate usando WlanGetSecuritySettings. Per altre informazioni sull'uso di oggetti a protezione diretta, vedere How DACLs Control Access to an Object .For more information about the use of securable objects, see How DACLs Control Access to an Object.

Sintassi

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;

Costanti


`wlan_secure_permit_list` Valore: 0 Autorizzazioni per la modifica dell'elenco di autorizzazioni per i profili utente. Gli elenchi di controllo di accesso discrezionale associati a questo oggetto a protezione diretta vengono recuperati quando WlanGetFilterList o WlanSetFilterList viene chiamato con wlanFilterList impostato su wlan_filter_list_type_user_permit. Affinché la chiamata WlanGetFilterList abbia esito positivo, l'elenco dati deve contenere una voce di controllo di accesso (ACE) che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetFilterList abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante.
`wlan_secure_deny_list` Autorizzazioni per la modifica dell'elenco di rifiuto per i profili utente. Il servizio di configurazione automatica non stabilisce una connessione a una rete nell'elenco nega. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanGetFilterList o WlanSetFilterList viene chiamato con wlanFilterListType impostato su wlan_filter_list_type_user_deny. Affinché la chiamata WlanGetFilterList abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetFilterList abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante.
`wlan_secure_ac_enabled` Autorizzazioni per abilitare il servizio di configurazione automatica. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanQueryInterface o WlanSetInterface viene chiamato con OpCode impostato su wlan_intf_opcode_autoconf_enabled. Affinché la chiamata WlanQueryInterface abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetInterface abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_bc_scan_enabled` Autorizzazioni per l'abilitazione delle analisi in background. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanQueryInterface o WlanSetInterface viene chiamato con OpCode impostato su wlan_intf_opcode_background_scan_enabled. Affinché la chiamata WlanQueryInterface abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetInterface abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_bss_type` Autorizzazioni per modificare il tipo di set di servizi di base. Il daCL associato a questo oggetto a protezione diretta viene recuperato quando WlanQueryInterface o WlanSetInterface viene chiamato con OpCode impostato su wlan_intf_opcode_bss_type. Affinché la chiamata WlanQueryInterface abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetInterface abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_show_denied` Le autorizzazioni per modificare se le reti nell'elenco nega vengono visualizzate nell'elenco reti disponibili. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanQueryAutoConfigParameter o WlanSetAutoConfigParameter viene chiamato con OpCode impostato su wlan_autoconf_opcode_show_denied_networks. Affinché la chiamata WlanQueryAutoConfigParameter abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_READ_ACCESS autorizzazione per il token di accesso del thread chiamante. Affinché la chiamata WlanSetAutoConfigParameter abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante.
`wlan_secure_interface_properties` Autorizzazioni per la modifica delle proprietà dell'interfaccia. Si tratta dell'oggetto a protezione diretta generica usato da WlanQueryInterface o WlanSetInterface quando non viene usato un altro oggetto a protezione diretta più specifico. Il relativo daCL viene recuperato ogni volta che WlanQueryInterface o WlanSetInterface è token di accesso del thread chiamante e OpCode è impostato su un valore diverso da wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled, wlan_intf_opcode_media_streaming_mode, wlan_intf_opcode_bss_type o wlan_intf_opcode_current_operation_mode. L'elenco dati non viene recuperato anche quando OpCode è impostato su wlan_intf_opcode_radio_state e il chiamante è l'utente della console. Affinché la chiamata WlanQueryInterface abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetInterface abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_ihv_control` Autorizzazioni per l'uso della funzione WlanIhvControl per il controllo indipendente del fornitore hardware (IHV) di driver o servizi WLAN. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando Viene chiamato WlanIhvControl . Affinché la chiamata abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante.
`wlan_secure_all_user_profiles_order` Autorizzazioni per la modifica dell'ordine dei profili utente. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato prima che WlanSetProfileList o WlanSetProfilePosition esegua un'operazione che modifica l'ordine relativo di tutti i profili utente nell'elenco dei profili o sposta un profilo utente in una posizione inferiore nell'elenco dei profili. Per la riuscita di una chiamata, l'elenco dati deve contenere un ACE che concede WLAN_WRITE_ACCESS l'autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_add_new_all_user_profiles` Autorizzazioni per l'aggiunta di nuovi profili utente. Nota Il descrittore di sicurezza associato a questo oggetto viene applicato ai nuovi profili utente creati. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanSetProfile viene chiamato con dwFlags impostato su 0. Affinché la chiamata abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante.
`wlan_secure_add_new_per_user_profiles` Autorizzazioni per l'aggiunta di nuovi profili per utente. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanSetProfile viene chiamato con dwFlags impostato su WLAN_PROFILE_USER. Affinché la chiamata abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante.
`wlan_secure_media_streaming_mode_enabled` Autorizzazioni per l'impostazione o l'esecuzione di query sulla modalità di streaming multimediale. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanQueryInterface o WlanSetInterface viene chiamato con OpCode impostato su wlan_intf_opcode_media_streaming_mode. Affinché la chiamata WlanQueryInterface abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetInterface abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_current_operation_mode` Autorizzazioni per l'impostazione o l'esecuzione di query sulla modalità di operazione dell'interfaccia wireless. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando WlanQueryInterface o WlanSetInterface viene chiamato con OpCode impostato su wlan_intf_opcode_current_operation_mode. Affinché la chiamata WlanQueryInterface abbia esito positivo, l'elenco dati deve contenere un ACE che concede WLAN_READ_ACCESS autorizzazione al token di accesso del thread chiamante. Affinché la chiamata WlanSetInterface abbia esito positivo, l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione per il token di accesso del thread chiamante.
`wlan_secure_get_plaintext_key` Autorizzazioni per il recupero della chiave di testo normale da un profilo wireless. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando la funzione WlanGetProfile viene chiamata con il flag WLAN_PROFILE_GET_PLAINTEXT_KEY impostato nel valore a cui punta il parametro pdwFlags sull'input. Affinché la chiamata WlanGetProfile abbia esito positivo, l'elenco dati deve contenere un ACE che concede l'autorizzazione WLAN_READ_ACCESS al token di accesso del thread chiamante. Per impostazione predefinita, le autorizzazioni per il recupero della chiave di testo normale sono consentite solo ai membri del gruppo Administrators in un computer locale. Windows 7: Questo valore è un'estensione per le API wireless native aggiunte in Windows 7 e versioni successive.
`wlan_secure_hosted_network_elevated_access` Autorizzazioni che hanno accesso con privilegi elevati per chiamare le funzioni di rete ospitata con privilegi. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando la funzione WlanHostedNetworkSetProperty viene chiamata con il parametro OpCode impostato su wlan_hosted_network_opcode_enable. Per l'esito positivo della chiamata WlanHostedNetworkSetProperty , l'elenco dati deve contenere un ace che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante. Per impostazione predefinita, l'autorizzazione per impostare la proprietà Rete ospitata wireless su wlan_hosted_network_opcode_enable è consentita solo ai membri del gruppo Administrators in un computer locale. L'elenco dati associato a questo oggetto a protezione diretta viene recuperato quando viene chiamata la funzione WlanHostedNetworkForceStart . Per la riuscita della chiamata WlanHostedNetworkForceStart , l'elenco dati deve contenere un ACE che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante. Per impostazione predefinita, l'autorizzazione per forzare l'avvio della rete ospitata wireless è consentita solo ai membri del gruppo Administrators in un computer locale. Windows 7: Questo valore è un'estensione per le API wireless native aggiunte in Windows 7 e versioni successive.
`wlan_secure_virtual_station_extensibility` Windows 7: Questo valore è un'estensione per le API wireless native aggiunte in Windows 7 e versioni successive.
`wlan_secure_wfd_elevated_access` Questo valore è riservato per l'uso interno dal servizio Wi-Fi Direct. Windows 8: Questo valore è un'estensione per le API wireless native aggiunte in Windows 8 e versioni successive.
`WLAN_SECURABLE_OBJECT_COUNT`

Commenti

Questi oggetti possono essere protetti usando WlanSetSecuritySettings. Le autorizzazioni correnti associate a questi oggetti possono essere recuperate usando WlanGetSecuritySettings. Per altre informazioni sull'uso di oggetti a protezione diretta, vedere How DACLs Control Access to an Object and Native Wifi API Permissions .For more information about the use of securable objects, see How DACLs Control Access to an Object and Native Wifi API Permissions.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	wlanapi.h