structure WLAN_BSS_ENTRY (wlanapi.h)
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 |
|---|---|
|
Spécifie un réseau BSS d’infrastructure. |
|
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.
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).
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour