WlanGetFilterList-Funktion (wlanapi.h)

Artikel
03/09/2024

Die WlanGetFilterList-Funktion ruft eine Gruppenrichtlinie oder Benutzerberechtigungsliste ab.

Syntax

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

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. Alle benutzerdefinierten und Gruppenrichtlinienfilterlisten können abgefragt werden.

pReserved

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

[out] ppNetworkList

Zeiger auf eine DOT11_NETWORK_LIST-Struktur , die die Liste der zulässigen oder verweigerten Netzwerke enthält.

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, um die Filterliste abzurufen. Wenn wlanFilterListType auf wlan_filter_list_type_user_permit festgelegt ist, ruft WlanGetFilterList die diskretionäre Zugriffssteuerungsliste (Discretionary Access Control List, DACL) ab, die mit dem wlan_secure_permit_list-Objekt gespeichert ist. Wenn wlanFilterListType auf wlan_filter_list_type_user_deny festgelegt ist, ruft WlanGetFilterList 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_READ_ACCESS Berechtigung für das Zugriffstoken des aufrufenden Threads gewährt, gibt WlanGetFilterListERROR_ACCESS_DENIED zurück.
ERROR_INVALID_PARAMETER	hClientHandle ist NULL oder ungültig, ppNetworkList ist NULL oder pReserved ist nicht NULL.
ERROR_INVALID_HANDLE	Das Handle hClientHandle wurde in der Handle-Tabelle 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-Client mit SP3 oder einer Wlan-LAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Benutzerberechtigungslisten können durch Aufrufen von WlanSetFilterList festgelegt werden.

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 (einschließlich Wlanapi.h)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll

Weitere Informationen

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList

Freigeben über