WlanSetFilterList-Funktion (wlanapi.h)

Artikel
03/04/2024

Die WlanSetFilterList-Funktion legt die Zulassungs-/Ablehnungsliste fest.

Syntax

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

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] wlanFilterListType

Ein WLAN_FILTER_LIST_TYPE Wert, der den Typ der Filterliste angibt. Der Wert muss entweder wlan_filter_list_type_user_permit oder wlan_filter_list_type_user_deny sein. Gruppenrichtliniendefinierte Listen können mit dieser Funktion nicht festgelegt werden.

[in, optional] pNetworkList

Zeiger auf eine DOT11_NETWORK_LIST Struktur, die die Liste der zuzulassenden oder verweigernden Netzwerke enthält. Der dwIndex-Member der -Struktur muss einen Wert aufweisen, der kleiner als der Wert des dwNumberOfItems-Elements der -Struktur ist. Andernfalls kann eine Zugriffsverletzung auftreten.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen zum Festlegen der Filterliste. Wenn wlanFilterListType auf wlan_filter_list_type_user_permit festgelegt ist, ruft WlanSetFilterList die mit dem wlan_secure_permit_list-Objekt gespeicherte DACL (Discretionary Access Control List) ab. Wenn wlanFilterListType auf wlan_filter_list_type_user_deny festgelegt ist, ruft WlanSetFilterList die mit dem wlan_secure_deny_list-Objekt gespeicherte DACL ab. Wenn die DACL in beiden Fällen keinen Zugriffssteuerungseintrag (Access Control Entry, ACE) enthält, der WLAN_WRITE_ACCESS Berechtigung für das Zugriffstoken des aufrufenden Threads gewährt, gibt WlanSetFilterListERROR_ACCESS_DENIED zurück.
ERROR_INVALID_PARAMETER	hClientHandle ist NULL oder ungültig, oder pReserved ist nicht NULL.
ERROR_INVALID_HANDLE	Das Handle hClientHandle wurde in der Handletabelle nicht gefunden.
ERROR_NOT_SUPPORTED	Diese Funktion wurde von einer nicht unterstützten Plattform aufgerufen. Dieser Wert wird zurückgegeben, wenn diese Funktion von einem Windows XP mit SP3 oder einer WLAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Die Gruppenrichtlinienlisten "Zulassen" und "Verweigern" haben Vorrang vor den Listen "Genehmigungen" und "Verweigern" des Benutzers. Das bedeutet, dass der Zugriff auf ein Netzwerk in der Zulassungsliste des Benutzers verweigert wird, wenn das Netzwerk in der Liste der Gruppenrichtlinienverweigerungen angezeigt wird. Ebenso ist der Zugriff auf ein Netzwerk in der Ablehnungsliste des Benutzers zulässig, wenn das Netzwerk in der Liste der Gruppenrichtliniengenehmigungen angezeigt wird. Netzwerke, die nicht in einer Benutzer- oder Gruppenrichtlinienliste enthalten sind, sind zulässig.

Verweigerte Netzwerke können nicht über die automatische Konfiguration verbunden werden und werden nicht in die Liste der sichtbaren Netzwerke aufgenommen. Neue Benutzerberechtigungs- und Ablehnungslisten überschreiben frühere Versionen der Benutzerlisten.

Um eine Filterliste zu löschen, legen Sie den pNetworkList-Parameter auf NULL fest, oder übergeben Sie einen Zeiger auf eine DOT11_NETWORK_LIST-Struktur , deren dwNumberOfItems-Member auf 0 festgelegt ist.

Um einer Filterliste alle SSIDs hinzuzufügen, übergeben Sie einen Zeiger auf eine DOT11_NETWORK_LIST-Struktur mit einer zugeordneten DOT11_NETWORK-Struktur , deren uSSIDLength-Member der DOT11_SSID-Struktur auf 0 festgelegt ist.

Um einer Filterliste alle BSS-Typen hinzuzufügen, übergeben Sie einen Zeiger auf eine DOT11_NETWORK_LIST mit einer zugeordneten DOT11_NETWORK-Struktur , deren dot11BssType-Member auf dot11_BSS_type_any festgelegt ist.

Die Befehle netsh wlan add filter und netsh wlan delete filter bieten ähnliche Funktionen in der Befehlszeile. Weitere Informationen finden Sie unter Netsh Commands for Wireless Local Area Network (WLAN).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wlanapi.h (wlanapi.h einschließen)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll

Weitere Informationen

WlanGetFilterList

Freigeben über