Fonction WlanSetFilterList (wlanapi.h)

Article
03/13/2024

La fonction WlanSetFilterList définit la liste d’autorisation/refus.

Syntaxe

DWORD WlanSetFilterList(
  [in]           HANDLE                    hClientHandle,
  [in]           WLAN_FILTER_LIST_TYPE     wlanFilterListType,
  [in, optional] const PDOT11_NETWORK_LIST pNetworkList,
                 PVOID                     pReserved
);

Paramètres

[in] hClientHandle

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. La valeur doit être wlan_filter_list_type_user_permit ou wlan_filter_list_type_user_deny. Les listes définies par une stratégie de groupe ne peuvent pas être définies à l’aide de cette fonction.

[in, optional] pNetworkList

Pointeur vers une structure DOT11_NETWORK_LIST qui contient la liste des réseaux à autoriser ou à refuser. Le membre dwIndex de la structure doit avoir une valeur inférieure à la valeur du membre dwNumberOfItems de la structure ; dans le cas contraire, une violation d’accès peut se produire.

pReserved

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

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 définir la liste de filtres. Lorsqu’il est appelé avec wlanFilterListType défini sur wlan_filter_list_type_user_permit, WlanSetFilterList 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, WlanSetFilterList récupère le DACL stocké avec l’objet wlan_secure_deny_list . Dans l’un ou l’autre de ces cas, si la liste DACL ne contient pas d’entrée de contrôle d’accès (ACE) qui accorde WLAN_WRITE_ACCESS autorisation au jeton d’accès du thread appelant, WlanSetFilterList retourne ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle est NULL ou non valide ou pReserved n’est pas NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table de handles.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur est retournée si cette fonction a été appelée à partir d’un windows XP avec SP3 ou de l’API LAN sans fil pour Windows XP avec un client SP2.
RPC_STATUS	Différents codes d’erreur.

Remarques

Les listes d’autorisation et de refus de stratégie de groupe sont prioritaires sur les listes d’autorisation et de refus de l’utilisateur. Cela signifie que l’accès à un réseau figurant dans la liste des autorisations de l’utilisateur sera refusé si le réseau apparaît sur la liste d’exclusion de la stratégie de groupe. De même, l’accès à un réseau dans la liste de refus de l’utilisateur est autorisé si le réseau apparaît dans la liste des autorisations de stratégie de groupe. Les réseaux qui ne figurent pas sur une liste d’utilisateurs ou une liste de stratégies de groupe seront autorisés.

Les réseaux refusés ne peuvent pas être connectés au moyen d’une configuration automatique et ne sont pas inclus dans la liste des réseaux visibles. Les nouvelles listes d’autorisations et de refus d’utilisateur remplacent les versions précédentes des listes d’utilisateurs.

Pour effacer une liste de filtres, définissez le paramètre pNetworkList sur NULL ou passez un pointeur vers une structure DOT11_NETWORK_LIST dont le membre dwNumberOfItems a la valeur 0.

Pour ajouter tous les SSID à une liste de filtres, passez un pointeur vers une structure DOT11_NETWORK_LIST avec une structure DOT11_NETWORK associée dont le membre uSSIDLength de sa structure DOT11_SSID est défini sur 0.

Pour ajouter tous les types BSS à une liste de filtres, passez un pointeur vers un DOT11_NETWORK_LIST avec une structure de DOT11_NETWORK associée dont le membre dot11BssType est défini sur dot11_BSS_type_any.

Les commandes netsh wlan add filter et netsh wlan delete filter offrent des fonctionnalités similaires sur la ligne de commande. Pour plus d’informations, consultez Commandes Netsh pour le réseau local sans fil (wlan).

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 (incluez Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll

Voir aussi

WlanGetFilterList

Partager via