Fonction WlanGetFilterList (wlanapi.h)

Article
03/04/2024

La fonction WlanGetFilterList récupère une stratégie de groupe ou une liste d’autorisations utilisateur.

Syntaxe

DWORD WlanGetFilterList(
  [in]  HANDLE                hClientHandle,
  [in]  WLAN_FILTER_LIST_TYPE wlanFilterListType,
        PVOID                 pReserved,
  [out] PDOT11_NETWORK_LIST   *ppNetworkList
);

Paramètres

[in] hClientHandle

Le handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .

[in] wlanFilterListType

Valeur WLAN_FILTER_LIST_TYPE qui spécifie le type de liste de filtres. Toutes les listes de filtres définies par l’utilisateur et de stratégie de groupe peuvent être interrogées.

pReserved

Réservé pour un usage futur. Doit être défini sur NULL.

[out] ppNetworkList

Pointeur vers une structure DOT11_NETWORK_LIST qui contient la liste des réseaux autorisés ou refusés.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.

Code de retour	Description
ERROR_ACCESS_DENIED	L’appelant ne dispose pas des autorisations suffisantes pour obtenir la liste de filtres. Lorsqu’il est appelé avec wlanFilterListType défini sur wlan_filter_list_type_user_permit, WlanGetFilterList récupère la liste de contrôle d’accès discrétionnaire (DACL) stockée avec l’objet wlan_secure_permit_list . Lorsqu’il est appelé avec wlanFilterListType défini sur wlan_filter_list_type_user_deny, WlanGetFilterList récupère le DACL stocké avec l’objet wlan_secure_deny_list . Dans l’un de ces cas, si la liste DACL ne contient pas d’entrée de contrôle d’accès (ACE) qui accorde à WLAN_READ_ACCESS l’autorisation au jeton d’accès du thread appelant, Alors WlanGetFilterList retourne ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle a la valeur NULL ou non valide, ppNetworkList a la valeur NULL ou pReserved n’est pas NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table handle.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur sera retournée si cette fonction a été appelée à partir d’un windows XP avec l’API LAN sans fil ou SP3 pour Windows XP avec le client SP2.
RPC_STATUS	Différents codes d’erreur.

Remarques

Vous pouvez définir des listes d’autorisations utilisateur en appelant WlanSetFilterList.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wlanapi.h (inclure Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll

Voir aussi

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList

Partager via