Funzione WlanGetFilterList (wlanapi.h)

Articolo
03/13/2024

La funzione WlanGetFilterList recupera un elenco di autorizzazioni utente o criteri di gruppo.

Sintassi

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

Parametri

[in] hClientHandle

Handle di sessione del client, ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] wlanFilterListType

Valore WLAN_FILTER_LIST_TYPE che specifica il tipo di elenco di filtri. È possibile eseguire query su tutti gli elenchi di filtri definiti dall'utente e di criteri di gruppo.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

[out] ppNetworkList

Puntatore a una struttura DOT11_NETWORK_LIST che contiene l'elenco di reti consentite o negate.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti per ottenere l'elenco di filtri. Quando viene chiamato con wlanFilterListType impostato su wlan_filter_list_type_user_permit, WlanGetFilterList recupera l'elenco di controllo di accesso discrezionale (DACL) archiviato con l'oggetto wlan_secure_permit_list . Quando viene chiamato con wlanFilterListType impostato su wlan_filter_list_type_user_deny, WlanGetFilterList recupera l'elenco DACL archiviato con l'oggetto wlan_secure_deny_list . In uno di questi casi, se l'elenco DACL non contiene una voce di controllo di accesso (ACE) che concede WLAN_READ_ACCESS l'autorizzazione al token di accesso del thread chiamante, WlanGetFilterList restituisce ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle è NULL o non valido, ppNetworkList è NULL o pReserved non è NULL.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
ERROR_NOT_SUPPORTED	Questa funzione è stata chiamata da una piattaforma non supportata. Questo valore verrà restituito se questa funzione è stata chiamata da un'API Windows XP con SP3 o LAN wireless per Windows XP con il client SP2.
RPC_STATUS	Vari codici di errore.

Commenti

Gli elenchi di autorizzazioni utente possono essere impostati chiamando WlanSetFilterList.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h (include Wlanapi.h)
Libreria	Wlanapi.lib
DLL	Wlanapi.dll

Vedi anche

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList

Condividi tramite