WLAN_CONNECTION_PARAMETERS struttura (wlanapi.h)

Articolo
08/28/2023

La struttura WLAN_CONNECTION_PARAMETERS specifica i parametri usati quando si usa la funzione WlanConnect .

Sintassi

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

Members

wlanConnectionMode

Valore WLAN_CONNECTION_MODE che specifica la modalità di connessione.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: È supportato solo il valore wlan_connection_mode_profile .

strProfile

Specifica il profilo usato per la connessione.

Se wlanConnectionMode è impostato su wlan_connection_mode_profile, strProfile specifica il nome del profilo usato per la connessione. Se wlanConnectionMode è impostato su wlan_connection_mode_temporary_profile, strProfile specifica la rappresentazione XML del profilo usato per la connessione. Se wlanConnectionMode è impostato su wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure, strProfile deve essere impostato su NULL.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Il profilo deve soddisfare i criteri di compatibilità descritti in Compatibilità del profilo wireless.

pDot11Ssid

Puntatore a una struttura DOT11_SSID che specifica il SSID della rete a cui connettersi. Questo parametro è facoltativo e, Se impostato su NULL, verranno provati tutti gli SSID nel profilo. Questo parametro non deve essere NULL se WLAN_CONNECTION_MODE è impostato su wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Puntatore a una struttura DOT11_BSSID_LIST che contiene l'elenco di identificatori BSS (Basic Service Set) desiderati per la connessione.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Questo membro deve essere NULL.

dot11BssType

Valore DOT11_BSS_TYPE che indica il tipo BSS della rete. Se viene fornito un profilo, questo tipo BSS deve essere uguale a quello del profilo.

dwFlags

La tabella seguente mostra i flag usati per specificare i parametri di connessione.

Costante	Valore	Descrizione
WLAN_CONNECTION_HIDDEN_NETWORK	0x00000001	Connettersi alla rete di destinazione anche se la destinazione è una rete nascosta. Una rete nascosta non trasmette il relativo SSID. Non usare questo flag se la rete di destinazione è una rete ad hoc. Se il profilo specificato da strProfile non è NULL, questo flag viene ignorato e l'elemento del profilo nonBroadcast determina se connettersi a una rete nascosta.
WLAN_CONNECTION_ADHOC_JOIN_ONLY	0x00000002	Non formare una rete ad hoc. Aggiungere una rete ad hoc solo se la rete esiste già. Non usare questo flag se la rete di destinazione è una rete di infrastruttura.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT	0x00000004	Ignorare il bit di privacy durante la connessione alla rete. Ignorando il bit di privacy ha l'effetto di ignorare se i pacchetti sono crittografati e ignorano il metodo di crittografia usato. Usare questo flag solo quando ci si connette a una rete di infrastruttura usando un profilo temporaneo.
WLAN_CONNECTION_EAPOL_PASSTHROUGH	0x00000008	Esentare il traffico EAPOL dalla crittografia e dalla decrittografia. Questo flag viene usato quando un'applicazione deve inviare il traffico EAPOL su una rete di infrastruttura che usa l'autenticazione Open e la crittografia WEP. Questo flag non deve essere usato per connettersi alle reti che richiedono l'autenticazione 802.1X. Questo flag è valido solo quando wlanConnectionMode è impostato su wlan_connection_mode_temporary_profile. Evitare di usare questo flag ogni volta che è possibile.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE	0x00000010	Rendere permanente automaticamente il profilo di individuazione al completamento della connessione. Questo flag è valido solo per wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure. Il profilo verrà salvato come un profilo utente, con il nome generato da SSID usando WlanUtf8SsidToDisplayName. Se è già presente un profilo con lo stesso nome, verrà aggiunto un numero alla fine del nome del profilo. Il profilo verrà salvato con la modalità di connessione manuale, a meno che non sia specificato WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO	0x00000020	Da usare in combinazione con WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Il profilo di individuazione verrà mantenuto con la modalità di connessione automatica.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING	0x00000040	Da usare in combinazione con WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Il profilo di individuazione verrà mantenuto e tenterà di sovrascrivere un profilo esistente con lo stesso nome.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Questo membro deve essere impostato su 0.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	wlanapi.h
Componente ridistribuibile	API LAN wireless per Windows XP con SP2

Vedi anche

WlanConnect

Condividi tramite