Funzione WlanSetAutoConfigParameter (wlanapi.h)

Articolo
08/28/2023

La funzione WlanSetAutoConfigParameter imposta i parametri per il servizio di configurazione automatica.

Sintassi

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

Parametri

[in] hClientHandle

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

[in] OpCode

Valore WLAN_AUTOCONF_OPCODE che specifica il parametro da impostare. Solo alcuni dei codici operativi nell'enumerazione WLAN_AUTOCONF_OPCODE supportano le operazioni del set.

Valore	Significato
wlan_autoconf_opcode_show_denied_networks	Se impostato, il parametro pData conterrà un valore BOOL che indica se le reti con criteri di gruppo e utente verranno incluse nell'elenco delle reti disponibili.
wlan_autoconf_opcode_allow_explicit_creds	Se impostato, il parametro pData conterrà un valore BOOL che indica se l'interfaccia wireless corrente ha credenziali utente condivise consentite.
wlan_autoconf_opcode_block_period	Se impostato, il parametro pData conterrà un valore DWORD per l'impostazione del periodo bloccato per l'interfaccia wireless corrente. Il periodo bloccato è la quantità di tempo, in secondi, per cui la connessione automatica a una rete wireless non verrà tentata dopo un errore precedente.
wlan_autoconf_opcode_allow_virtual_station_extensibility	Se impostato, il parametro pData conterrà un valore BOOL che indica se l'estendibilità in una stazione virtuale è consentita. Per impostazione predefinita, l'estendibilità in una stazione virtuale è consentita. Il valore di questo codice operativo viene salvato in modo permanente tra i riavvii. Questo valore di enumerazione è supportato in Windows 7 e in Windows Server 2008 R2 con il servizio LAN wireless installato.

[in] dwDataSize

Dimensioni del parametro pData , in byte. Questo parametro deve essere impostato su sizeof(BOOL) per un valore BOOL o sizeof(DWORD) per un valore DWORD, a seconda del valore del parametro OpCode .

[in] pData

Valore da impostare per il parametro specificato nel parametro OpCode . Il parametro pData deve puntare a un valore booleano o DWORD, a seconda del valore del parametro OpCode . Il parametro pData non deve essere NULL.

Nota Il parametro pData può puntare a un valore intero quando è necessario un valore booleano. Se pData punta a 0, il valore viene convertito in FALSE. Se pData punta a un numero intero diverso da zero, il valore viene convertito in TRUE.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

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	Accesso negato. Questo errore viene restituito se il chiamante non dispone di autorizzazioni sufficienti per impostare il parametro di configurazione quando il parametro OpCode è wlan_autoconf_opcode_show_denied_networks o wlan_autoconf_opcode_allow_virtual_station_extensibility. Quando il parametro OpCode è impostato su uno di questi valori, la funzione WlanSetAutoConfigParameter recupera l'elenco di controllo di accesso discrezionale (DACL) archiviato per l'oggetto opcode. Se l'elenco DACL non contiene una voce di controllo di accesso (ACE) che concede WLAN_WRITE_ACCESS l'autorizzazione al token di accesso del thread chiamante, WlanSetAutoConfigParameter restituisce ERROR_ACCESS_DENIED. Questo errore viene restituito anche se il parametro di configurazione è impostato da Criteri di gruppo in un dominio. Quando i criteri di gruppo sono impostati per un codice operativo, le applicazioni non possono apportare modifiche. Per i parametri OpCode seguenti possono essere impostati da Criteri di gruppo: wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds e wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER	Un parametro non è valido. Questo errore viene restituito se il parametro hClientHandle è NULL, il parametro pData è NULL o il parametro pReserved non è NULL. Questo errore viene restituito anche se il parametro OpCode specificato non è uno dei valori WLAN_AUTOCONF_OPCODE per un parametro di configurazione che può essere impostato. Questo errore viene restituito anche se il parametro dwDataSize non è impostato su `sizeof(BOOL)`o dwDataSize non è impostato su `sizeof(BOOL)` a seconda del valore del parametro OpCode .
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

La funzione WlanSetAutoConfigParameter imposta i parametri usati da Auto Configuration Module (ACM), il componente di configurazione wireless supportato in Windows Vista e versioni successive.

A seconda del valore del parametro OpCode , i dati a cui punta pData verranno convertiti in un valore booleano prima che venga impostato il parametro di configurazione automatica. Se pData punta a 0, il parametro viene impostato su FALSE; in caso contrario, il parametro è impostato su TRUE.

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

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter

Condividi tramite