Fonction WlanHostedNetworkQueryStatus (wlanapi.h)
La fonction WlanHostedNetworkQueryStatus interroge la status actuelle du réseau hébergé sans fil.
Syntaxe
DWORD WlanHostedNetworkQueryStatus(
[in] HANDLE hClientHandle,
[out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
PVOID pvReserved
);
Paramètres
[in] hClientHandle
Handle de session du client, retourné par un appel précédent à la fonction WlanOpenHandle .
[out] ppWlanHostedNetworkStatus
Lors de l’entrée, ce paramètre doit être NULL.
À la sortie, ce paramètre reçoit un pointeur vers le status actuel du réseau hébergé sans fil, si l’appel à la fonction WlanHostedNetworkQueryStatus réussit. Le status actuel est retourné dans une structure WLAN_HOSTED_NETWORK_STATUS.
pvReserved
Réservé pour un usage futur. Ce paramètre doit être NULL.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.
| Code de retour | Description |
|---|---|
|
Un handle n’est pas valide. Cette erreur est retournée si le handle spécifié dans le paramètre hClientHandle est introuvable dans la table de handle. |
|
Un paramètre est incorrect. Cette erreur est retournée si l’une des conditions suivantes se produit :
|
|
La ressource n’est pas dans l’état correct pour effectuer l’opération demandée. Cela peut se produire si le réseau hébergé sans fil était en cours d’arrêt. |
|
Le service n'a pas été démarré. Cette erreur est retournée si le service de configuration automatique WLAN n’est pas en cours d’exécution. |
|
Divers codes d’erreur RPC et autres. Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée. |
Remarques
La fonction WlanHostedNetworkQueryStatus 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 Windows Server 2008 R2 avec le service LAN sans fil installé.
Une application cliente appelle la fonction WlanHostedNetworkQueryStatus pour interroger la status actuelle du réseau hébergé sans fil. Cette fonction ne modifie pas l’état du réseau hébergé sans fil.
Si la fonction réussit, le paramètre ppWlanHostedNetworkStatus pointe vers une structure WLAN_HOSTED_NETWORK_STATUS avec la status actuelle. La mémoire utilisée pour la structure WLAN_HOSTED_NETWORK_STATUS retournée doit être libérée après utilisation en appelant la fonction WlanFreeMemory .
Tout utilisateur peut appeler la fonction WlanHostedNetworkQueryStatus pour interroger le réseau hébergé. Toutefois, la possibilité d’activer le réseau hébergé sans fil peut être limitée par la stratégie de groupe dans un domaine.
Sur Windows 7 et versions ultérieures, le système d’exploitation installe un appareil virtuel si une carte sans fil compatible réseau hébergé est présente sur l’ordinateur. Cet appareil virtuel s’affiche normalement dans le dossier « Network Connections » en tant que « Connexion réseau sans fil 2 » avec le nom de l’appareil « Microsoft Virtual WiFi Miniport adapter » si l’ordinateur dispose d’une seule carte réseau sans fil. Cet appareil virtuel est utilisé exclusivement pour effectuer des connexions de point d’accès logiciel (SoftAP) et n’est pas présent dans la liste retournée par la fonction WlanEnumInterfaces . La durée de vie de cet appareil virtuel est liée à l’adaptateur sans fil physique. Si l’adaptateur sans fil physique est désactivé, cet appareil virtuel est également supprimé. Cette fonctionnalité est également disponible sur Windows Server 2008 R2 avec le service LAN sans fil installé.
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] |
| Plateforme cible | Windows |
| En-tête | wlanapi.h (incluez Wlanapi.h) |
| Bibliothèque | Wlanapi.lib |
| DLL | Wlanapi.dll |
Voir aussi
À propos du réseau hébergé sans fil
Utilisation du réseau hébergé sans fil et du partage de connexion Internet
WlanHostedNetworkQueryProperty