Fonction WFDCancelOpenSession (wlanapi.h)
La fonction WFDCancelOpenSession indique que l’application souhaite annuler une fonction WFDStartOpenSession en attente qui n’est pas terminée.
Syntaxe
DWORD WFDCancelOpenSession(
[in] HANDLE hSessionHandle
);
Paramètres
[in] hSessionHandle
Un handle de session à une Wi-Fi session directe à annuler. 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. |
|
Différents codes d’erreur. |
Remarques
La fonction WFDCancelOpenSession 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.
Un appel à la fonction WFDCancelOpenSession avertit le service direct Wi-Fi que le client demande l’annulation de cette session. La fonction WFDCancelOpenSession ne modifie pas le comportement WFDStartOpenSession attendu. La fonction de rappel spécifiée à la fonction WFDStartOpenSession est toujours appelée, et la fonction WFDStartOpenSession peut ne pas être terminée immédiatement.
Il incombe à l’appelant de passer à la fonction WFDCancelOpenSession un handle dans le paramètre hSessionHandle qui a été retourné par l’appel à la fonction WFDStartOpenSession .
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 |