WLAN_CONNECTION_PARAMETERS struttura (wlanapi.h)
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 |