struttura WLAN_AVAILABLE_NETWORK (wlanapi.h)

La struttura WLAN_AVAILABLE_NETWORK contiene informazioni su una rete wireless disponibile.

Sintassi

typedef struct _WLAN_AVAILABLE_NETWORK {
  WCHAR                  strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID             dot11Ssid;
  DOT11_BSS_TYPE         dot11BssType;
  ULONG                  uNumberOfBssids;
  BOOL                   bNetworkConnectable;
  WLAN_REASON_CODE       wlanNotConnectableReason;
  ULONG                  uNumberOfPhyTypes;
  DOT11_PHY_TYPE         dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER];
  BOOL                   bMorePhyTypes;
  WLAN_SIGNAL_QUALITY    wlanSignalQuality;
  BOOL                   bSecurityEnabled;
  DOT11_AUTH_ALGORITHM   dot11DefaultAuthAlgorithm;
  DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
  DWORD                  dwFlags;
  DWORD                  dwReserved;
} WLAN_AVAILABLE_NETWORK, *PWLAN_AVAILABLE_NETWORK;

Members

strProfileName[WLAN_MAX_NAME_LENGTH]

Contiene il nome del profilo associato alla rete. Se la rete non ha un profilo, questo membro sarà vuoto. Se alla rete sono associati più profili, nell'elenco di rete visibile saranno presenti più voci con lo stesso SSID. I nomi dei profili fanno distinzione tra maiuscole e minuscole. Questa stringa deve essere con terminazione NULL.

dot11Ssid

Struttura DOT11_SSID che contiene l'SSID della rete wireless visibile.

dot11BssType

Valore DOT11_BSS_TYPE che specifica se la rete è infrastruttura o ad hoc.

uNumberOfBssids

Indica il numero di BSSID nella rete.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: uNumberofBssids è al massimo 1, indipendentemente dal numero di punti di accesso che trasmettono il SSID.

bNetworkConnectable

Indica se la rete è connettibile o meno. Se è impostata su TRUE, la rete è connettibile; in caso contrario, la rete non può essere connessa.

wlanNotConnectableReason

Valore WLAN_REASON_CODE che indica il motivo per cui una rete non può essere connessa. Questo membro è valido solo quando bNetworkConnectable è FALSE.

uNumberOfPhyTypes

Numero di tipi PHY supportati nelle reti disponibili. Il valore massimo di uNumberOfPhyTypes è WLAN_MAX_PHY_TYPE_NUMBER, che ha un valore pari a 8. Se sono supportati più di WLAN_MAX_PHY_TYPE_NUMBER tipi PHY, bMorePhyTypes deve essere impostato su TRUE.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

Contiene una matrice di valori DOT11_PHY_TYPE che rappresentano i tipi PHY supportati dalle reti disponibili. Quando uNumberOfPhyTypes è maggiore di WLAN_MAX_PHY_TYPE_NUMBER, questa matrice contiene solo i primi tipi PHY WLAN_MAX_PHY_TYPE_NUMBER .

Valore	Significato
dot11_phy_type_unknown	Specifica un tipo PHY sconosciuto o non inizializzato.
dot11_phy_type_any	Specifica qualsiasi tipo PHY.
dot11_phy_type_fhss	Specifica un PHY (FHSS) di tipo frequency-hopping spread-spectrum (FHSS). I dispositivi Bluetooth possono usare FHSS o un adattamento di FHSS.
dot11_phy_type_dsss	Specifica uno spettro di diffusione della sequenza diretta (DSSS).
dot11_phy_type_irbaseband	Specifica un PHY a banda base infrarossa (IR).
dot11_phy_type_ofdm	Specifica una divisione di frequenza ortogonale a multiplexing (OFDM) PHY. I dispositivi 802.11a possono usare OFDM.
dot11_phy_type_hrdsss	Specifica un PHY DSSS (HRDSSS) ad alta frequenza.
dot11_phy_type_erp	Specifica una frequenza estesa PHY (ERP). I dispositivi 802.11g possono usare ERP.
dot11_phy_type_ht	Specifica un tipo PHY 802.11n.
dot11_phy_type_vht	Specifica il tipo PHY 802.11ac. Si tratta del tipo PHY con velocità effettiva molto elevata specificato in IEEE 802.11ac. Questo valore è supportato in Windows 8.1, Windows Server 2012 R2 e versioni successive.
dot11_phy_type_IHV_start	Specifica l'inizio dell'intervallo utilizzato per definire i tipi PHY sviluppati da un fornitore hardware indipendente (IHV).
dot11_phy_type_IHV_end	Specifica la fine dell'intervallo utilizzato per definire i tipi PHY sviluppati da un fornitore hardware indipendente (IHV).

bMorePhyTypes

Specifica se sono supportati più di WLAN_MAX_PHY_TYPE_NUMBER tipi PHY.

Quando questo membro è impostato su TRUE, un'applicazione deve chiamare WlanGetNetworkBssList per ottenere l'elenco completo dei tipi PHY. La struttura WLAN_BSS_LIST restituita ha una matrice di strutture WLAN_BSS_ENTRY . Il membro uPhyId della struttura WLAN_BSS_ENTRY contiene il tipo PHY per una voce.

wlanSignalQuality

Valore percentuale che rappresenta la qualità del segnale della rete. WLAN_SIGNAL_QUALITY è di tipo ULONG. Questo membro contiene un valore compreso tra 0 e 100. Un valore pari a 0 implica una potenza effettiva del segnale RSSI pari a -100 dbm. Un valore pari a 100 implica una potenza effettiva del segnale RSSI pari a -50 dbm. È possibile calcolare il valore di intensità del segnale RSSI per i valori wlanSignalQuality compresi tra 1 e 99 usando l'interpolazione lineare.

bSecurityEnabled

Indica se la sicurezza è abilitata nella rete. Un valore TRUE indica che la sicurezza è abilitata; in caso contrario, non è .

dot11DefaultAuthAlgorithm

Valore DOT11_AUTH_ALGORITHM che indica l'algoritmo di autenticazione predefinito usato per aggiungere la rete per la prima volta.

dot11DefaultCipherAlgorithm

Valore DOT11_CIPHER_ALGORITHM che indica l'algoritmo di crittografia predefinito da utilizzare durante l'aggiunta alla rete.

dwFlags

Contiene vari flag per la rete.

Valore	Significato
WLAN_AVAILABLE_NETWORK_CONNECTED	Questa rete è attualmente connessa.
WLAN_AVAILABLE_NETWORK_HAS_PROFILE	Esiste un profilo per questa rete.

dwReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

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

WLAN_AVAILABLE_NETWORK_LIST