structure WLAN_HOSTED_NETWORK_STATUS (wlanapi.h)

Article
08/28/2023

La structure WLAN_HOSTED_NETWORK_STATUS contient des informations sur la status du réseau hébergé sans fil.

Syntaxe

typedef struct _WLAN_HOSTED_NETWORK_STATUS {
  WLAN_HOSTED_NETWORK_STATE      HostedNetworkState;
  GUID                           IPDeviceID;
  DOT11_MAC_ADDRESS              wlanHostedNetworkBSSID;
  DOT11_PHY_TYPE                 dot11PhyType;
  ULONG                          ulChannelFrequency;
  DWORD                          dwNumberOfPeers;
#if ...
  WLAN_HOSTED_NETWORK_PEER_STATE *PeerList[];
#else
  WLAN_HOSTED_NETWORK_PEER_STATE PeerList[1];
#endif
} WLAN_HOSTED_NETWORK_STATUS, *PWLAN_HOSTED_NETWORK_STATUS;

Membres

HostedNetworkState

État actuel du réseau hébergé sans fil.

Si la valeur de ce membre est wlan_hosted_network_unavailable, les valeurs des autres champs de cette structure ne doivent pas être utilisées.

IPDeviceID

ID d’appareil réseau réel utilisé pour le réseau hébergé sans fil.

Il s’agit du GUID d’un appareil sans fil virtuel qui ne serait pas disponible via les appels à la fonction WlanEnumInterfaces . Ce GUID peut être utilisé pour appeler d’autres fonctions réseau de couche supérieure qui utilisent le GUID de l’appareil (fonctions d’assistance IP, par exemple).

wlanHostedNetworkBSSID

BSSID utilisé par le réseau hébergé sans fil dans les paquets, les balises et les réponses de sonde.

dot11PhyType

Type physique de l’interface réseau utilisée par le réseau hébergé sans fil.

Il s’agit de l’un des types signalés par l’interface physique associée. Cette valeur est correcte uniquement si le membre HostedNetworkState est wlan_hosted_network_active.

ulChannelFrequency

Fréquence de canal de l’interface réseau utilisée par le réseau hébergé sans fil.

Cette valeur est correcte uniquement si HostedNetworkState est wlan_hosted_network_active.

dwNumberOfPeers

Nombre actuel d’homologues authentifiés sur le réseau hébergé sans fil.

Cette valeur est correcte uniquement si HostedNetworkState est wlan_hosted_network_active.

PeerList[*]

Tableau de structures WLAN_HOSTED_NETWORK_PEER_STATE décrivant chacun des homologues actuels sur le réseau hébergé sans fil. Le nombre d’éléments dans le tableau est donné par le membre dwNumberOfPeers .

Cette valeur est correcte uniquement si HostedNetworkState est wlan_hosted_network_active.

PeerList[1]

Cette valeur est correcte uniquement si HostedNetworkState est wlan_hosted_network_active.

Remarques

La structure WLAN_HOSTED_NETWORK_STATUS est une extension des API sans fil natives ajoutées pour prendre en charge le réseau hébergé sans fil sur Windows 7 et versions ultérieures.

La structure WLAN_HOSTED_NETWORK_STATUS est retournée dans un pointeur dans le paramètre ppWlanHostedNetworkStatus par la fonction WlanHostedNetworkQueryStatus .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	wlanapi.h (incluez Wlanapi.h)