énumération WLAN_SECURABLE_OBJECT (wlanapi.h)

Article
08/28/2023

Le type WLAN_SECURABLE_OBJECT énuméré définit les objets sécurisables utilisés par Native Wifi Functions.

Ces objets peuvent être sécurisés à l’aide de WlanSetSecuritySettings. Les autorisations actuelles associées à ces objets peuvent être récupérées à l’aide de WlanGetSecuritySettings. Pour plus d’informations sur l’utilisation d’objets sécurisables, consultez How DACLs Control Access to an Object.

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;

Constantes


`wlan_secure_permit_list` Valeur : 0 Autorisations permettant de modifier la liste d’autorisations pour les profils utilisateur. Les listes de contrôle d’accès discrétionnaire (DACL) associées à cet objet sécurisable sont récupérées lorsque WlanGetFilterList ou WlanSetFilterList est appelé avec wlanFilterListType défini sur wlan_filter_list_type_user_permit. Pour que l’appel WlanGetFilterList réussisse, la liste DACL doit contenir une entrée de contrôle d’accès (ACE) qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetFilterList réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_deny_list` Autorisations permettant de modifier la liste de refus pour les profils utilisateur. Le service de configuration automatique n’établit pas de connexion à un réseau figurant dans la liste de refus. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanGetFilterList ou WlanSetFilterList est appelé avec wlanFilterListType défini sur wlan_filter_list_type_user_deny. Pour que l’appel WlanGetFilterList réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetFilterList réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_ac_enabled` Autorisations permettant d’activer le service de configuration automatique. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanQueryInterface ou WlanSetInterface est appelé avec OpCode défini sur wlan_intf_opcode_autoconf_enabled. Pour que l’appel WlanQueryInterface réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetInterface réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_bc_scan_enabled` Autorisations permettant d’activer les analyses en arrière-plan. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanQueryInterface ou WlanSetInterface est appelé avec OpCode défini sur wlan_intf_opcode_background_scan_enabled. Pour que l’appel WlanQueryInterface réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetInterface réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_bss_type` Autorisations permettant de modifier le type de jeu de services de base. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanQueryInterface ou WlanSetInterface est appelé avec OpCode défini sur wlan_intf_opcode_bss_type. Pour que l’appel WlanQueryInterface réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetInterface réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_show_denied` Autorisations permettant de modifier si les réseaux de la liste de refus apparaissent dans la liste des réseaux disponibles. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanQueryAutoConfigParameter ou WlanSetAutoConfigParameter est appelé avec OpCode défini sur wlan_autoconf_opcode_show_denied_networks. Pour que l’appel WlanQueryAutoConfigParameter réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetAutoConfigParameter réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_interface_properties` Autorisations permettant de modifier les propriétés de l’interface. Il s’agit de l’objet sécurisable générique utilisé par WlanQueryInterface ou WlanSetInterface lorsqu’un autre objet sécurisable plus spécifique n’est pas utilisé. Sa liste DACL est récupérée chaque fois que WlanQueryInterface ou WlanSetInterface est un jeton d’accès du thread appelant et que l’OpCode est défini sur une valeur autre que wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled, wlan_intf_opcode_media_streaming_mode, wlan_intf_opcode_bss_type ou wlan_intf_opcode_current_operation_mode. La liste dacl n’est pas récupérée non plus lorsque OpCode est défini sur wlan_intf_opcode_radio_state et que l’appelant est l’utilisateur de la console. Pour que l’appel WlanQueryInterface réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetInterface réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_ihv_control` Autorisations d’utilisation de la fonction WlanIhvControl pour le contrôle IHV (Independent Hardware Vendor) des pilotes ou services WLAN. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanIhvControl est appelé. Pour que l’appel réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_all_user_profiles_order` Autorisations permettant de modifier l’ordre des profils tous utilisateurs. La liste DACL associée à cet objet sécurisable est récupérée avant que WlanSetProfileList ou WlanSetProfilePosition n’effectue une opération qui modifie l’ordre relatif des profils tous les utilisateurs dans la liste des profils ou déplace un profil tout utilisateur vers une position inférieure dans la liste des profils. Pour que l’un ou l’autre appel réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_add_new_all_user_profiles` Autorisations pour l’ajout de nouveaux profils tous utilisateurs. Note Le descripteur de sécurité associé à cet objet est appliqué aux nouveaux profils tous utilisateurs créés. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanSetProfile est appelé avec dwFlags défini sur 0. Pour que l’appel réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_add_new_per_user_profiles` Autorisations pour l’ajout de nouveaux profils par utilisateur. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanSetProfile est appelé avec dwFlags défini sur WLAN_PROFILE_USER. Pour que l’appel réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_media_streaming_mode_enabled` Autorisations permettant de définir ou d’interroger le mode de streaming multimédia. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanQueryInterface ou WlanSetInterface est appelé avec OpCode défini sur wlan_intf_opcode_media_streaming_mode. Pour que l’appel WlanQueryInterface réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetInterface réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_current_operation_mode` Autorisations permettant de définir ou d’interroger le mode de fonctionnement de l’interface sans fil. La liste DACL associée à cet objet sécurisable est récupérée lorsque WlanQueryInterface ou WlanSetInterface est appelé avec OpCode défini sur wlan_intf_opcode_current_operation_mode. Pour que l’appel WlanQueryInterface réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Pour que l’appel WlanSetInterface réussisse, la liste dacl doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant.
`wlan_secure_get_plaintext_key` Autorisations permettant de récupérer la clé de texte brut à partir d’un profil sans fil. La liste DACL associée à cet objet sécurisable est récupérée lorsque la fonction WlanGetProfile est appelée avec l’indicateur WLAN_PROFILE_GET_PLAINTEXT_KEY défini dans la valeur pointée par le paramètre pdwFlags en entrée. Pour que l’appel WlanGetProfile réussisse, la liste DACL doit contenir un ACE qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant. Par défaut, les autorisations de récupération de la clé de texte brut sont autorisées uniquement aux membres du groupe Administrateurs sur un ordinateur local. Windows 7 : Cette valeur est une extension des API sans fil natives ajoutées sur Windows 7 et versions ultérieures.
`wlan_secure_hosted_network_elevated_access` Autorisations qui ont un accès élevé pour appeler les fonctions de réseau hébergé privilégié. La liste DACL associée à cet objet sécurisable est récupérée lorsque la fonction WlanHostedNetworkSetProperty est appelée avec le paramètre OpCode défini sur wlan_hosted_network_opcode_enable. Pour que l’appel WlanHostedNetworkSetProperty réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant. Par défaut, l’autorisation de définir la propriété Réseau hébergé sans fil sur wlan_hosted_network_opcode_enable est autorisée uniquement aux membres du groupe Administrateurs sur un ordinateur local. La liste DACL associée à cet objet sécurisable est récupérée lorsque la fonction WlanHostedNetworkForceStart est appelée. Pour que l’appel WlanHostedNetworkForceStart réussisse, la liste de contrôle d’accès doit contenir un ACE qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant. Par défaut, l’autorisation de forcer le démarrage du réseau hébergé sans fil est autorisée uniquement aux membres du groupe Administrateurs sur un ordinateur local. Windows 7 : Cette valeur est une extension des API sans fil natives ajoutées sur Windows 7 et versions ultérieures.
`wlan_secure_virtual_station_extensibility` Windows 7 : Cette valeur est une extension des API sans fil natives ajoutées sur Windows 7 et versions ultérieures.
`wlan_secure_wfd_elevated_access` Cette valeur est réservée à une utilisation interne par le service Direct Wi-Fi. Windows 8 : Cette valeur est une extension des API sans fil natives ajoutées sur Windows 8 et versions ultérieures.
`WLAN_SECURABLE_OBJECT_COUNT`

Remarques

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	wlanapi.h