Funzione WlanSetFilterList (wlanapi.h)

Articolo
08/28/2023

La funzione WlanSetFilterList imposta l'elenco permit/deny.

Sintassi

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

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. Il valore deve essere wlan_filter_list_type_user_permit o wlan_filter_list_type_user_deny. Gli elenchi definiti dai criteri di gruppo non possono essere impostati usando questa funzione.

[in, optional] pNetworkList

Puntatore a una struttura DOT11_NETWORK_LIST che contiene l'elenco di reti da consentire o negare. Il membro dwIndex della struttura deve avere un valore minore del valore del membro dwNumberOfItems della struttura; in caso contrario, può verificarsi una violazione di accesso.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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 impostare l'elenco di filtri. Quando viene chiamato con wlanFilterListType impostato su wlan_filter_list_type_user_permit, WlanSetFilterList recupera l'elenco di controllo di accesso discrezionale archiviato con l'oggetto wlan_secure_permit_list . Quando viene chiamato con wlanFilterListType impostato su wlan_filter_list_type_user_deny, WlanSetFilterList recupera l'elenco dati archiviato con l'oggetto wlan_secure_deny_list. In uno di questi casi, se l'elenco dati non contiene una voce di controllo di accesso (ACE) che concede l'autorizzazione WLAN_WRITE_ACCESS al token di accesso del thread chiamante, WlanSetFilterList restituisce ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle è NULL o non valido 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 WIRELESS LAN per Windows XP con il client SP2.
RPC_STATUS	Vari codici di errore.

Commenti

I criteri di gruppo consentono e negano gli elenchi hanno la precedenza sugli elenchi consentiti e negati dell'utente. Ciò significa che l'accesso a una rete nell'elenco di autorizzazioni dell'utente verrà negato se la rete viene visualizzata nell'elenco di rifiuto dei criteri di gruppo. Analogamente, l'accesso a una rete nell'elenco di rifiuto dell'utente sarà consentito se la rete viene visualizzata nell'elenco dei criteri di gruppo. Le reti che non si trovano in un elenco di utenti o in un elenco di criteri di gruppo saranno consentite.

Le reti negate non possono essere connesse tramite la configurazione automatica e non verranno incluse nell'elenco reti visibili. Nuovi elenchi consentiti e negati sovrascrivono le versioni precedenti degli elenchi di utenti.

Per cancellare un elenco di filtri, impostare il parametro pNetworkList su NULL o passare un puntatore a una struttura DOT11_NETWORK_LIST con il membro dwNumberOfItems impostato su 0.

Per aggiungere tutti gli SSID a un elenco di filtri, passare un puntatore a una struttura DOT11_NETWORK_LIST con una struttura DOT11_NETWORK associata con il membro uSSIDLengthdella struttura DOT11_SSID impostata su 0.

Per aggiungere tutti i tipi BSS a un elenco di filtri, passare un puntatore a un DOT11_NETWORK_LIST con una struttura DOT11_NETWORK associata con il membro dot11BssType impostato su dot11_BSS_type_any.

I comandi di filtro di eliminazione di netsh wlane netsh wlan aggiungono funzionalità simili alla riga di comando. Per altre informazioni, vedere Comandi netsh per la rete locale wireless (wlan).

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

WlanGetFilterList

Condividi tramite