Fonction WFDOpenHandle (wlanapi.h)
La fonction WFDOpenHandle ouvre un handle au service direct Wi-Fi et négocie une version de l’API Wi-FI Direct à utiliser.
Syntaxe
DWORD WFDOpenHandle(
[in] DWORD dwClientVersion,
[out] PDWORD pdwNegotiatedVersion,
[out] PHANDLE phClientHandle
);
Paramètres
[in] dwClientVersion
Version la plus élevée de l’API direct Wi-Fi prise en charge par le client.
Pour Windows 8 et Windows Server 2012, ce paramètre doit être défini sur WFD_API_VERSION, constante définie dans le fichier d’en-tête Wlanapi.h.
[out] pdwNegotiatedVersion
Pointeur vers un DWORD pour recevoir la version négociée.
Si la fonction WFDOpenHandle réussit, la version négociée avec le service direct Wi-Fi à utiliser par cette session est retournée. Cette valeur est généralement la version la plus élevée prise en charge par le client et Wi-Fi service Direct.
[out] phClientHandle
Pointeur vers un HANDLE pour recevoir le handle vers le service direct Wi-Fi pour cette session.
Si la fonction WFDOpenHandle réussit, un handle à l'Wi-Fi service Direct à utiliser dans cette session est retourné.
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 paramètre est incorrect.
Cette erreur est retournée si le paramètre pdwNegotiatedVersion a la valeur NULL ou si le paramètre phClientHandle a la valeur NULL. Cette valeur est également retournée si le paramètre dwClientVersion n’est pas égal à WFD_API_VERSION. |
|
Le stockage disponible est insuffisant pour traiter cette commande.
Cette erreur est retournée si le système n’a pas pu allouer de mémoire pour créer le contexte client. |
|
Une tentative a été effectuée pour établir une session sur un serveur réseau, mais il y a déjà trop de sessions établies sur ce serveur.
Cette erreur est retournée si trop de handles ont été émis par le service direct Wi-Fi. |
|
Différents codes d’erreur. |
Remarques
La fonction WFDOpenHandle 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
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour