Fonction WFDCloseHandle (wlanapi.h)
La fonction WFDCloseHandle ferme un handle au service direct Wi-Fi.
Syntaxe
DWORD WFDCloseHandle(
[in] HANDLE hClientHandle
);
Paramètres
[in] hClientHandle
Un handle client pour le service direct Wi-Fi. Ce handle a été obtenu par un appel précédent à la fonction WFDOpenHandle .
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 hClientHandle n’a pas été trouvé dans la table handle. |
|
Le paramètre est incorrect.
Cette erreur est retournée si le paramètre hClientHandle a la valeur NULL ou n’est pas valide. |
|
Différents codes d’erreur. |
Remarques
La fonction WFDCloseHandle 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 Wi-Fi spécification technique pair-à-pair v1.1 par l’alliance Wi-Fi (voir Spécifications publiées de l’Alliance Wi-Fi). 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 pour configurer la connexion ou l’utilisation du mécanisme ibss (IBSS) Wi-Fi existant.
Pour utiliser Wi-Fi Direct, une application doit d’abord obtenir un handle pour le service Direct Wi-Fi en appelant la fonction WFDOpenHandle . Le handle Wi-Fi Direct (WFD) retourné par la fonction WFDOpenHandle est utilisé pour les appels ultérieurs effectués au service Direct Wi-Fi. Une fois qu’une application est terminée à l’aide du service direct Wi-Fi, l’application doit appeler la fonction WFDCloseHandle pour signaler au Wi-Fi service Direct que l’application est effectuée à l’aide du service. Cela permet au service direct Wi-Fi de libérer les ressources utilisées par l’application.
Configuration requise
| 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 |