Funzione WlanQueryAutoConfigParameter (wlanapi.h)

Articolo
08/28/2023

La funzione WlanQueryAutoConfigParameter esegue query sui parametri del servizio di configurazione automatica.

Sintassi

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

Parametri

[in] hClientHandle

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

[in] OpCode

Valore che specifica il parametro di configurazione da eseguire una query.

Valore	Significato
wlan_autoconf_opcode_show_denied_networks	Se impostato, il parametro ppData conterrà un valore BOOL che indica se le reti con criteri di gruppo e utente verranno incluse nell'elenco delle reti disponibili. Se la funzione restituisce ERROR_SUCCESS e ppData punta a TRUE, le reti con criteri di gruppo e utente verranno incluse nell'elenco delle reti disponibili; se FALSE, le reti negate dai criteri di gruppo e utente non verranno incluse nell'elenco delle reti disponibili.
wlan_autoconf_opcode_power_setting	Se impostato, il parametro ppData conterrà un valore WLAN_POWER_SETTING che specifica le impostazioni di alimentazione.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks	Se impostato, il parametro ppData conterrà un valore BOOL che indica se i profili non creati dai criteri di gruppo possono essere usati per connettersi a una rete consentita con un profilo di criteri di gruppo corrispondente. Se la funzione restituisce ERROR_SUCCESS e ppData punta a TRUE, è possibile usare solo i profili creati dai criteri di gruppo; se FALSE, è possibile usare qualsiasi profilo.
wlan_autoconf_opcode_allow_explicit_creds	Se impostato, il parametro ppData conterrà un valore BOOL che indica se l'interfaccia wireless corrente ha credenziali utente condivise consentite. Se la funzione restituisce ERROR_SUCCESS e ppData punta a TRUE, l'interfaccia wireless corrente ha le credenziali utente condivise consentite; se FALSE, l'interfaccia wireless corrente non consente le credenziali utente condivise.
wlan_autoconf_opcode_block_period	Se impostato, il parametro ppData conterrà un valore DWORD che indica 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 ppData 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 per questo opcode viene mantenuto tra i riavvii. Se la funzione restituisce ERROR_SUCCESS e ppData punta a TRUE, l'estendibilità in una stazione virtuale è consentita; se FALSE, l'estendibilità in una stazione virtuale non è consentita.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

[out] pdwDataSize

Specifica le dimensioni del parametro ppData , in byte.

[out] ppData

Puntatore alla memoria contenente il valore query per il parametro specificato in OpCode.

Nota Se OpCode è impostato su wlan_autoconf_opcode_show_denied_networks, il puntatore a cui fa riferimento ppData può puntare a un valore intero. Se il puntatore a cui fa riferimento ppData punta a 0, il valore intero deve essere convertito nel valore booleano FALSE. Se il puntatore a cui fa riferimento ppData punta a un intero diverso da zero, il valore intero deve essere convertito nel valore booleano TRUE.

[out, optional] pWlanOpcodeValueType

Valore WLAN_OPCODE_VALUE_TYPE .

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 ottenere parametri di configurazione. Quando viene chiamato con OpCode impostato su wlan_autoconf_opcode_show_denied_networks, WlanQueryAutoConfigParameter recupera l'elenco di controllo di accesso discrezionale archiviato con l'oggetto wlan_secure_show_denied . Se l'elenco dati non contiene una voce di controllo di accesso (ACE) che concede l'autorizzazione WLAN_READ_ACCESS al token di accesso del thread chiamante, WlanQueryAutoConfigParameter restituisce ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle è NULL o non valido,pReserved non è NULL, ppData è NULL o pdwDataSize è 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

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

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

WlanSetAutoConfigParameter

Condividi tramite