WLAN_BSS_ENTRY struttura (wlanapi.h)

Articolo
03/13/2024

La struttura WLAN_BSS_ENTRY contiene informazioni su un set di servizi di base .BSS.

Sintassi

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

Members

dot11Ssid

SSID del punto di accesso (AP) o della stazione peer associata a BSS. Il tipo di dati per questo membro è una struttura DOT11_SSID .

uPhyId

Identificatore (ID) dell'interfaccia PHY usata per rilevare la rete BSS.

dot11Bssid

Indirizzo MAC (Media Access Control) del punto di accesso per le reti BSS dell'infrastruttura o della peer station per reti BSS indipendenti (reti ad hoc) che hanno inviato il frame 802.11 Beacon o Probe Response ricevuto dall'interfaccia LAN wireless durante l'analisi. Il tipo di dati per questo membro è una struttura DOT11_MAC_ADDRESS .

dot11BssType

Tipo di rete BSS. Il tipo di dati per questo membro è un valore di enumerazione DOT11_BSS_TYPE .

Questo membro può essere uno dei valori seguenti.

Valore	Significato
dot11_BSS_type_infrastructure 1	Specifica una rete BSS dell'infrastruttura.
dot11_BSS_type_independent 2	Specifica una rete BSS (IBSS) indipendente (una rete ad hoc).

dot11BssPhyType

Tipo PHY per questa rete. Il tipo di dati per questo membro è un valore di enumerazione DOT11_PHY_TYPE .

lRssi

Valore DELL'indicatore di forza del segnale ricevuto (RSSI), in unità di decibel a cui si fa riferimento a 1,0 milliwatts (dBm), come rilevato dal driver di interfaccia LAN wireless per l'API o la stazione peer.

uLinkQuality

Qualità del collegamento segnalata dal driver di interfaccia LAN wireless. Il valore di qualità del collegamento varia da 0 a 100. Un valore pari a 100 specifica la qualità di collegamento più alta.

bInRegDomain

Valore che specifica se l'API o la stazione peer operano all'interno del dominio normativo come identificato dal paese/area geografica.

Se il driver dell'interfaccia LAN wireless non supporta più domini normativi, questo membro è impostato su TRUE.

Se il frame 802.11 Beacon o Probe Response ricevuto dall'AP o dalla peer station non include un elemento Informazioni paese (IE), questo membro è impostato su TRUE.

Se il frame 802.11 Beacon o Probe Response ricevuto dall'API o dalla peer station include un'operatore di Internet Explorer del paese, questo membro viene impostato su FALSE se il valore del sottocampo Country String non è uguale alla stringa del paese di input.

usBeaconPeriod

Valore del campo Intervallo di beacon dal frame Di risposta di beacon o probe 802.11 ricevuto dall'interfaccia LAN wireless.

L'intervallo è compreso tra 1.024 unità di tempo di microsecondo tra i tempi di trasmissione del beacon di destinazione. Queste informazioni vengono recuperate dal pacchetto di beacon inviato da un punto di accesso in una rete BSS dell'infrastruttura o da una risposta probe da un punto di accesso o da una stazione peer in risposta a un client LAN wireless che invia una richiesta probe.

Lo standard IEEE 802.11 definisce un'unità di tempo uguale a 1.024 microsecondi. Questa unità è stata definita in modo che possa essere facilmente implementata nell'hardware.

ullTimestamp

Il valore del campo Timestamp dal frame Beacon o Probe Response 802.11 ricevuto dall'interfaccia LAN wireless.

ullHostTimestamp

Valore timestamp host che registra quando l'interfaccia LAN wireless ha ricevuto il frame Di risposta di Beacon o Probe. Questo membro è un conteggio di 100-nanosecondi intervalli dal 1° gennaio 1601.

Per altre informazioni, vedere la funzione NdisGetCurrentSystemTime documentata in WDK.

usCapabilityInformation

Valore del campo Informazioni sulle funzionalità dal frame Di risposta del beacon o probe 802.11 ricevuto dall'interfaccia LAN wireless. Questo valore è un set di flag di bit che definiscono la funzionalità.

Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
ESS bit 0	Set di servizi esteso. Set di uno o più set di servizi di base interconnessi (BSS) e reti locali integrate (LAN) che vengono visualizzate come un singolo BSS al livello di controllo del collegamento logico in qualsiasi stazione associata a una di queste reti BSS. Un'API imposta il sottocampo ESS su 1 e il sottocampo IBSS su 0 all'interno di frame di risposta di beacon o probe trasmessi. Una stazione peer all'interno di una rete IBSS (rete ad hoc) imposta il sottocampo ESS su 0 e il sottocampo IBSS su 1 in frame di risposta di beacon o probe trasmessi.
IBSS bit 1	Set di servizi di base indipendente. BSS che forma una rete autonoma e in cui non è disponibile alcun accesso a un sistema di distribuzione (DS) (una rete ad hoc). Un'API imposta il sottocampo ESS su 1 e il sottocampo IBSS su 0 all'interno di frame di risposta di beacon o probe trasmessi. Una stazione peer all'interno di una rete IBSS (rete ad hoc) imposta il sottocampo ESS su 0 e il sottocampo IBSS su 1 in frame di risposta di beacon o probe trasmessi.
CF-Pollable bit 2	Valore che indica se l'API o la stazione peer è pollable.
Richiesta di polling CF bit 3	Valore che indica come l'AP o la peer station gestisce le richieste di polling.
Privacy bit 4	Valore che indica se la crittografia è necessaria per tutti i frame di dati. Un'API imposta il sottocampo privacy su 1 all'interno di frame di risposta di beacon e probe trasmessi se la crittografia WEP, WPA o WPA2 è necessaria per tutti i frame di tipo di dati scambiati all'interno del servizio BSS. Se la crittografia WEP, WPA o WPA2 non è necessaria, il sottocampo Privacy è impostato su 0. Una stazione peer all'interno e IBSS imposta il sottocampo Privacy su 1 all'interno di frame di beacon e probe di risposta trasmessi se la crittografia WEP, WPA o WPA2 è necessaria per tutti i frame di tipo di dati scambiati all'interno di IBSS. Se la crittografia WEP, WPA o WPA2 non è necessaria, il sottocampo Privacy è impostato su 0.

ulChCenterFrequency

Frequenza del centro del canale della banda in cui è stato ricevuto il frame Di risposta del beacon o probe 802.11. Il valore di ulChCenterFrequency è in unità di kilohertz (kHz).

Nota Questo membro è valido solo per i tipi PHY che non sono spettro di diffusione di frequenza (FHSS).

wlanRateSet

Set di velocità di trasferimento dei dati supportate dal servizio BSS. Il tipo di dati per questo membro è una struttura WLAN_RATE_SET .

ulIeOffset

Offset, in byte, del BLOB di dati dell'elemento information (IE) dall'inizio della struttura WLAN_BSS_ENTRY .

Questo membro punta a un buffer che contiene elementi di informazioni a lunghezza variabile (IES) dai frame Di risposta 802.11 Beacon o Probe. Per ogni BSS, gli IES provengono dall'ultimo frame Di risposta di beacon o probe ricevuti dalla rete BSS. Se un IE è disponibile in un solo frame, il driver dell'interfaccia LAN wireless unisce l'IE con gli altri IE dall'ultimo frame di risposta di Beacon o Probe ricevuti.

Gli elementi informativi sono definiti nelle specifiche IEEE 802.11 per avere un formato generale comune costituito da un campo ID elemento a 1 byte, un campo Lunghezza a 1 byte e un campo informativo specifico dell'elemento a lunghezza variabile. Ogni elemento informativo viene assegnato un valore id elemento univoco come definito in questo standard IEEE 802.11. Il campo Lunghezza specifica il numero di byte nel campo informazioni.

ulIeSize

Dimensioni, in byte, del BLOB di dati di Internet Explorer nella struttura WLAN_BSS_ENTRY .

Si tratta della lunghezza esatta dei dati nel buffer a cui punta il membro ulIeOffset e non contiene alcuna spaziatura interna per l'allineamento. Il valore massimo per le dimensioni del BLOB di dati di Internet Explorer è di 2.324 byte.

Commenti

La funzione WlanGetNetworkBssList recupera l'elenco BSS della rete wireless o delle reti in un'interfaccia specifica e restituisce queste informazioni in una struttura WLAN_BSS_LIST che contiene una matrice di . WLAN_BSS_ENTRY strutture.

Quando l'interfaccia LAN wireless funziona anche come rete ospitata wireless, l'elenco BSS conterrà una voce per il servizio BSS creato per la rete ospitata wireless.

Poiché le informazioni vengono restituite dal punto di accesso per una rete BSS dell'infrastruttura o dal peer di rete per una rete BSS indipendente (rete ad hoc), le informazioni restituite non devono essere attendibili. I membri ulIeOffset e ulIeSize nella struttura WLAN_BSS_ENTRY devono essere usati per determinare la dimensione massima del BLOB dati dell'elemento informativo nella struttura WLAN_BSS_ENTRY , non i dati nel BLOB dati dell'elemento informativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	wlanapi.h

Vedi anche

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList

Condividi tramite