Fonction WFDCloseSession (wlanapi.h)
La fonction WFDCloseSession ferme une session après un appel réussi à la fonction WFDStartOpenSession .
Syntaxe
DWORD WFDCloseSession(
[in] HANDLE hSessionHandle
);
Paramètres
[in] hSessionHandle
Un handle de session vers une session Wi-Fi Direct. Il s’agit d’un handle de session précédemment retourné par la fonction WFDStartOpenSession .
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 |
|---|---|
|
Le handle n'est pas valide.
Cette erreur est retournée si le handle spécifié dans le paramètre hSessionHandle est introuvable dans la table de handle. |
|
Le paramètre est incorrect.
Cette erreur est retournée si le paramètre hSessionHandle est NULL ou non valide. |
|
Le groupe ou la ressource n’est pas dans l’état correct pour effectuer l’opération nécessaire.
Cette erreur est retournée si le service direct Wi-Fi est désactivé par la stratégie de groupe sur un domaine. |
|
Différents codes d’erreur. |
Remarques
La fonction WFDCloseSession fait partie de Wi-Fi Direct, une nouvelle fonctionnalité dans Windows 8 et Windows Server 2012. Wi-Fi Direct est basé sur le développement de la spécification technique Wi-Fi pair à pair v1.1 par la Wi-Fi Alliance (voir Spécifications publiées de Wi-Fi Alliance). L’objectif de la spécification technique d’égal à égal Wi-Fi est de fournir une solution pour Wi-Fi connectivité appareil à appareil sans avoir besoin d’un point d’accès sans fil (AP sans fil) pour configurer la connexion ou d’utiliser le mécanisme ibsS (Wi-Fi ad hoc) existant.
La fonction WFDCloseSession met en file d’attente un élément de travail futur pour fermer la session, de sorte que la déconnexion peut ne pas être immédiate.
L’appel de la fonction WFDCloseSession alors qu’un appel WFDStartOpenSession est en attente ne ferme pas la session.
Il incombe à l’appelant de passer à la fonction WFDCloseSession un handle dans le paramètre hSessionHandle qui a été retourné par un appel asynchrone réussi à la fonction WFDStartOpenSession .
L’appel de la fonction WFDCloseSession avec un handle qui était valide et est devenu non valide génère des résultats non définis.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wlanapi.h |
| Bibliothèque | Wlanapi.lib |
| DLL | Wlanapi.dll |