Partager via


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
ERROR_INVALID_HANDLE
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.

ERROR_INVALID_PARAMETER
Le paramètre est incorrect.

Cette erreur est retournée si le paramètre hSessionHandle est NULL ou non valide.

ERROR_INVALID_STATE
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.

RPC_STATUS
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

Voir aussi

WFDCancelOpenSession

WFDCloseHandle

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK