WlanGetFilterList-Funktion (wlanapi.h)
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 |