structure WLAN_BSS_ENTRY (wlanapi.h)

Article
03/04/2024

La structure WLAN_BSS_ENTRY contient des informations sur un ensemble de services de base (BSS).

Syntaxe

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;

Membres

dot11Ssid

SSID du point d’accès (AP) ou de la station homologue associée au BSS. Le type de données de ce membre est une structure DOT11_SSID .

uPhyId

Identificateur (ID) du PHY utilisé par l’interface LAN sans fil pour détecter le réseau BSS.

dot11Bssid

Adresse MAC (Media Access Control) du point d’accès pour les réseaux BSS d’infrastructure ou la station d’homologue pour les réseaux BSS indépendants (réseaux ad hoc) qui ont envoyé le cadre de réponse beacon ou sonde 802.11 reçu par l’interface LAN sans fil lors de l’analyse. Le type de données de ce membre est une structure DOT11_MAC_ADDRESS .

dot11BssType

Type de réseau BSS. Le type de données de ce membre est une valeur d’énumération DOT11_BSS_TYPE .

Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
dot11_BSS_type_infrastructure 1	Spécifie un réseau BSS d’infrastructure.
dot11_BSS_type_independent 2	Spécifie un réseau BSS (IBSS) indépendant (un réseau ad hoc).

dot11BssPhyType

Type PHY pour ce réseau. Le type de données de ce membre est une valeur d’énumération DOT11_PHY_TYPE .

lRssi

Valeur de l’indicateur d’intensité du signal (RSSI) reçue, en unités de décibels référencés à 1,0 milliwatts (dBm), telle que détectée par le pilote d’interface LAN sans fil pour l’AP ou la station homologue.

uLinkQuality

Qualité de liaison signalée par le pilote d’interface LAN sans fil. La valeur de qualité du lien varie de 0 à 100. La valeur 100 spécifie la qualité de liaison la plus élevée.

bInRegDomain

Valeur qui spécifie si l’AP ou la station d’homologue fonctionne dans le domaine réglementaire identifié par le pays/la région.

Si le pilote d’interface LAN sans fil ne prend pas en charge plusieurs domaines réglementaires, ce membre est défini sur TRUE.

Si le cadre de réponse de balise ou de sonde 802.11 reçu de l’AP ou de la station homologue n’inclut pas d’élément d’informations pays (IE), ce membre est défini sur TRUE.

Si le cadre de réponse à la balise ou à la sonde 802.11 reçu de l’AP ou de la station homologue inclut un IE pays, ce membre a la valeur FALSE si la valeur du sous-champ Country String n’est pas égale à la chaîne de pays d’entrée.

usBeaconPeriod

Valeur du champ Intervalle de balise de la trame de réponse beacon ou sonde 802.11 reçue par l’interface LAN sans fil.

L’intervalle est de 1 024 unités de temps de microsecondes entre les temps de transmission des balises cibles. Ces informations sont récupérées à partir du paquet de balise envoyé par un point d’accès dans un réseau BSS d’infrastructure ou d’une réponse de sonde à partir d’un point d’accès ou d’une station d’homologue en réponse à un client LAN sans fil qui envoie une demande de sonde.

La norme IEEE 802.11 définit une unité de temps comme égale à 1 024 microsecondes. Cette unité a été définie afin qu’elle puisse être facilement implémentée dans le matériel.

ullTimestamp

Valeur du champ Timestamp du cadre de réponse de balise ou de sonde 802.11 reçu par l’interface LAN sans fil.

ullHostTimestamp

Valeur d’horodatage de l’hôte qui enregistre quand l’interface LAN sans fil a reçu le cadre de réponse de la balise ou de la sonde. Ce membre est un nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601.

Pour plus d’informations, consultez la fonction NdisGetCurrentSystemTime documentée dans le WDK.

usCapabilityInformation

Valeur du champ Informations sur la capacité du cadre de réponse de balise ou de sonde 802.11 reçu par l’interface LAN sans fil. Cette valeur est un ensemble d’indicateurs de bits qui définissent la fonctionnalité.

Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
ESS bit 0	Ensemble de services étendus. Ensemble d’un ou plusieurs ensembles de services de base (BSS) interconnectés et de réseaux locaux intégrés (LAN) qui apparaît comme un seul BSS à la couche de contrôle de liaison logique à n’importe quelle station associée à l’une de ces BSS. Un point d’accès définit le sous-champ ESS sur 1 et le sous-champ IBSS sur 0 dans les trames de réponse de balise ou de sonde transmises. Une station d’homologue au sein d’un réseau IBSS (réseau ad hoc) définit le sous-champ ESS sur 0 et le sous-champ IBSS sur 1 dans les trames de balise ou de réponse de sonde transmises.
IBSS bit 1	Un ensemble de services de base indépendant. BSS qui forme un réseau autonome et dans lequel aucun accès à un système de distribution (DS) n’est disponible (réseau ad hoc). Un point d’accès définit le sous-champ ESS sur 1 et le sous-champ IBSS sur 0 dans les trames de balise ou de réponse de sonde transmises. Une station d’homologue au sein d’un réseau IBSS (réseau ad hoc) définit le sous-champ ESS sur 0 et le sous-champ IBSS sur 1 dans les trames de balise ou de réponse de sonde transmises.
CF-Pollable bit 2	Valeur qui indique si l’AP ou la station d’homologue est interrogeable.
Demande de sondage cf bit 3	Valeur qui indique comment l’AP ou la station homologue gère les demandes d’interrogation.
Confidentialité bit 4	Valeur qui indique si le chiffrement est requis pour toutes les trames de données. Un AP définit le sous-champ Confidentialité sur 1 dans les trames de balise et de réponse de sonde transmises si le chiffrement WEP, WPA ou WPA2 est requis pour tous les trames de type de données échangées dans le BSS. Si le chiffrement WEP, WPA ou WPA2 n’est pas requis, le sous-champ Confidentialité est défini sur 0. Une station homologue dans et IBSS définit le sous-champ Confidentialité sur 1 dans les trames de réponse de balise et de sonde transmises si le chiffrement WEP, WPA ou WPA2 est requis pour toutes les trames de type de données échangées au sein de l’IBSS. Si le chiffrement WEP, WPA ou WPA2 n’est pas requis, le sous-champ Confidentialité est défini sur 0.

ulChCenterFrequency

Fréquence centrale du canal de la bande sur laquelle le cadre de réponse beacon ou sonde 802.11 a été reçu. La valeur de ulChCenterFrequency est en unités de kilohertz (kHz).

Note Ce membre n’est valide que pour les types PHY qui ne sont pas du spectre de propagation à saut de fréquence (FHSS).

wlanRateSet

Un ensemble de taux de transfert de données pris en charge par BSS. Le type de données de ce membre est une structure WLAN_RATE_SET .

ulIeOffset

Décalage, en octets, de l’objet blob de données d’élément d’information (IE) à partir du début de la structure WLAN_BSS_ENTRY .

Ce membre pointe vers une mémoire tampon qui contient des éléments d’informations de longueur variable (EE) des trames de réponse de balise ou de sonde 802.11. Pour chaque BSS, les EE proviennent de la dernière trame de réponse de balise ou de sonde reçue de ce réseau BSS. Si un Internet Explorer n’est disponible que dans une seule image, le pilote d’interface LAN sans fil fusionne l’IE avec les autres IE à partir de la dernière trame de réponse de balise ou de sonde reçue.

Les éléments d’information sont définis dans les spécifications IEEE 802.11 pour avoir un format général commun composé d’un champ ID d’élément de 1 octet, d’un champ Longueur d’un octet et d’un champ d’informations spécifiques à un élément de longueur variable. Chaque élément d’information se voit attribuer une valeur d’ID d’élément unique telle que définie dans cette norme IEEE 802.11. Le champ Longueur spécifie le nombre d’octets dans le champ d’informations.

ulIeSize

Taille, en octets, de l’objet blob de données IE dans la structure WLAN_BSS_ENTRY .

Il s’agit de la longueur exacte des données dans la mémoire tampon pointée par le membre ulIeOffset et ne contient aucun remplissage pour l’alignement. La valeur maximale de la taille de l’objet blob de données d’Internet Explorer est de 2 324 octets.

Remarques

La fonction WlanGetNetworkBssList récupère la liste BSS du ou des réseaux sans fil sur une interface donnée et retourne ces informations dans une structure WLAN_BSS_LIST qui contient un tableau de . WLAN_BSS_ENTRY structures.

Lorsque l’interface LAN sans fil fonctionne également en tant que réseau hébergé sans fil , la liste BSS contient une entrée pour le BSS créé pour le réseau hébergé sans fil.

Étant donné que les informations sont retournées par le point d’accès d’un réseau BSS d’infrastructure ou par l’homologue réseau d’un réseau BSS indépendant (réseau ad hoc), les informations retournées ne doivent pas être approuvées. Les membres ulIeOffset et ulIeSize de la structure WLAN_BSS_ENTRY doivent être utilisés pour déterminer la taille maximale de l’objet blob de données d’élément d’information dans la structure WLAN_BSS_ENTRY , et non les données de l’objet blob de données d’élément d’information.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	wlanapi.h

Voir aussi

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList

Partager via