structure WLAN_HOSTED_NETWORK_STATUS (wlanapi.h)
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]
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.
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) |