structure WLAN_AVAILABLE_NETWORK (wlanapi.h)

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.

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.

dwReserved

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

Configuration requise

Voir aussi

WLAN_AVAILABLE_NETWORK_LIST