Fonction WlanRegisterVirtualStationNotification (wlanapi.h)
La fonction WlanRegisterVirtualStationNotification est utilisée pour inscrire et annuler l’inscription des notifications sur une station virtuelle.
Syntaxe
DWORD WlanRegisterVirtualStationNotification(
[in] HANDLE hClientHandle,
[in] BOOL bRegister,
PVOID pReserved
);
Paramètres
[in] hClientHandle
Handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .
[in] bRegister
Valeur qui spécifie s’il faut recevoir des notifications sur une station virtuelle.
pReserved
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 paramètre est incorrect. Cette erreur est retournée si l’une des conditions suivantes se produit :
|
|
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. |
|
La ressource n’est pas dans l’état correct pour effectuer l’opération demandée. Cette erreur est retournée si le réseau hébergé sans fil est désactivé par la stratégie de groupe sur un domaine. |
|
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 WlanRegisterVirtualStationNotification 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 WlanRegisterVirtualStationNotification est utilisée pour inscrire et annuler l’inscription des notifications sur la station virtuelle.
Toute inscription pour recevoir des notifications d’une station virtuelle provoquée par cette fonction est automatiquement annulée si l’application appelante ferme son handle d’appel (en appelant WlanCloseHandle avec le paramètre hClientHandle ) ou si le processus se termine.
Par défaut, un client d’application ne reçoit pas de notifications sur une station virtuelle. Pour recevoir ces notifications, un client doit appeler la fonction WlanRegisterVirtualStationNotification avec le paramètre bRegister défini sur TRUE et doit également appeler la fonction WlanRegisterNotification avec le paramètre dwNotifSource défini sur les sources de notification à inscrire. L’inscription pour recevoir des notifications d’une station virtuelle est en vigueur jusqu’à ce que l’application ferme le handle client (en appelant WlanCloseHandle avec le paramètre hClientHandle ), que le processus se termine ou que la fonction WlanRegisterVirtualStationNotification soit appelée avec le paramètre bRegister défini sur FALSE.
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 Connexions réseau sous la forme « Connexion réseau sans fil 2 » avec le nom de l’appareil « Carte miniport Microsoft Virtual WiFi » 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é.
Spécifications
| 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