Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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. |
|
hClientHandle ist NULL oder ungültig, ppNetworkList ist NULL oder pReserved ist nicht NULL. |
|
Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden. |
|
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. |
|
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 |