structure WLAN_AVAILABLE_NETWORK (wlanapi.h)

Article
03/13/2024

La structure WLAN_AVAILABLE_NETWORK contient des informations sur un réseau sans fil disponible.

Syntaxe

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;

Membres

strProfileName[WLAN_MAX_NAME_LENGTH]

Contient le nom de profil associé au réseau. Si le réseau n’a pas de profil, ce membre sera vide. Si plusieurs profils sont associés au réseau, il y aura plusieurs entrées avec le même SSID dans la liste des réseaux visibles. Les noms de profil respectent la casse. Cette chaîne doit être terminée par null.

dot11Ssid

Structure DOT11_SSID qui contient le SSID du réseau sans fil visible.

dot11BssType

Valeur DOT11_BSS_TYPE qui spécifie si le réseau est une infrastructure ou ad hoc.

uNumberOfBssids

Indique le nombre de BSSID dans le réseau.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : uNumberofBssids est au maximum 1, quel que soit le nombre de points d’accès diffusant le SSID.

bNetworkConnectable

Indique si le réseau est connectable ou non. S’il est défini sur TRUE, le réseau peut être connecté, sinon le réseau ne peut pas être connecté.

wlanNotConnectableReason

Valeur WLAN_REASON_CODE qui indique pourquoi un réseau ne peut pas être connecté. Ce membre est valide uniquement lorsque bNetworkConnectable a la valeur FALSE.

uNumberOfPhyTypes

Nombre de types PHY pris en charge sur les réseaux disponibles. La valeur maximale de uNumberOfPhyTypes est WLAN_MAX_PHY_TYPE_NUMBER, qui a la valeur 8. Si plus de WLAN_MAX_PHY_TYPE_NUMBER types PHY sont pris en charge, bMorePhyTypes doit avoir la valeur TRUE.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

Contient un tableau de valeurs DOT11_PHY_TYPE qui représentent les types PHY pris en charge par les réseaux disponibles. Lorsque uNumberOfPhyTypes est supérieur à WLAN_MAX_PHY_TYPE_NUMBER, ce tableau contient uniquement les premiers WLAN_MAX_PHY_TYPE_NUMBER types PHY.

Valeur	Signification
dot11_phy_type_unknown	Spécifie un type PHY inconnu ou non initialisé.
dot11_phy_type_any	Spécifie n’importe quel type PHY.
dot11_phy_type_fhss	Spécifie un phy du spectre d’écart de fréquence (FHSS). Les appareils Bluetooth peuvent utiliser FHSS ou une adaptation de FHSS.
dot11_phy_type_dsss	Spécifie un DSSS (Direct Sequence Spread Spectrum) PHY.
dot11_phy_type_irbaseband	Spécifie un phy de bande de base infrarouge (IR).
dot11_phy_type_ofdm	Spécifie un multiplexage de division de fréquence orthogonale (OFDM) PHY. Les appareils 802.11a peuvent utiliser OFDM.
dot11_phy_type_hrdsss	Spécifie un PHY DSSS (HRDSSS) à haut débit.
dot11_phy_type_erp	Spécifie un taux étendu PHY (ERP). Les appareils 802.11g peuvent utiliser ERP.
dot11_phy_type_ht	Spécifie un type PHY 802.11n.
dot11_phy_type_vht	Spécifie le type PHY 802.11ac. Il s’agit du type PHY à très haut débit spécifié dans IEEE 802.11ac. Cette valeur est prise en charge sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.
dot11_phy_type_IHV_start	Spécifie le début de la plage utilisée pour définir les types PHY développés par un fournisseur de matériel indépendant (IHV).
dot11_phy_type_IHV_end	Spécifie la fin de la plage utilisée pour définir les types PHY qui sont développés par un fournisseur de matériel indépendant (IHV).

bMorePhyTypes

Spécifie s’il existe plus de WLAN_MAX_PHY_TYPE_NUMBER types PHY pris en charge.

Lorsque ce membre est défini sur TRUE, une application doit appeler WlanGetNetworkBssList pour obtenir la liste complète des types PHY. La structure de WLAN_BSS_LIST retournée a un tableau de structures WLAN_BSS_ENTRY . Le membre uPhyId de la structure WLAN_BSS_ENTRY contient le type PHY d’une entrée.

wlanSignalQuality

Valeur de pourcentage qui représente la qualité du signal du réseau. WLAN_SIGNAL_QUALITY est de type ULONG. Ce membre contient une valeur comprise entre 0 et 100. La valeur 0 implique une force de signal RSSI réelle de -100 dbm. Une valeur de 100 implique une force de signal RSSI réelle de -50 dbm. Vous pouvez calculer la valeur de force du signal RSSI pour les valeurs wlanSignalQuality comprises entre 1 et 99 à l’aide de l’interpolation linéaire.

bSecurityEnabled

Indique si la sécurité est activée sur le réseau. La valeur TRUE indique que la sécurité est activée, sinon elle ne l’est pas.

dot11DefaultAuthAlgorithm

Valeur DOT11_AUTH_ALGORITHM qui indique l’algorithme d’authentification par défaut utilisé pour rejoindre ce réseau pour la première fois.

dot11DefaultCipherAlgorithm

Valeur DOT11_CIPHER_ALGORITHM qui indique l’algorithme de chiffrement par défaut à utiliser lors de la jonction de ce réseau.

dwFlags

Contient différents indicateurs pour le réseau.

Valeur	Signification
WLAN_AVAILABLE_NETWORK_CONNECTED	Ce réseau est actuellement connecté.
WLAN_AVAILABLE_NETWORK_HAS_PROFILE	Il existe un profil pour ce réseau.

dwReserved

Réservé pour un usage futur. Doit être défini sur NULL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	wlanapi.h
Composant redistribuable	API LAN sans fil pour Windows XP avec SP2

Voir aussi

WLAN_AVAILABLE_NETWORK_LIST

Share via