Fonction WFDOpenLegacySession (wlanapi.h)

Article
03/04/2024

La fonction WFDOpenLegacySession récupère et applique un profil stocké pour un appareil hérité Wi-Fi Direct.

Syntaxe

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

Paramètres

hClientHandle

Handle pour le service direct Wi-Fi pour cette session. Ce paramètre est récupéré à l’aide de la fonction WFDOpenHandle .

pLegacyMacAddress

Pointeur vers Wi-Fi adresse d’appareil direct de l’appareil client hérité.

phSessionHandle

Pointeur vers un HANDLE pour recevoir le handle vers le service direct Wi-Fi pour cette session.

Si la fonction WFDOpenLegacySession réussit, un handle au service direct Wi-Fi à utiliser dans cette session est retourné.

pGuidSessionInterface

Pointeur vers le GUID de l’interface réseau pour cette session.

Si la fonction WFDOpenLegacySession réussit, un GUID de l’interface réseau sur lequel Wi-Fi session direct 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
ERROR_INVALID_PARAMETER	Le paramètre est incorrect. Cette erreur est retournée si le paramètre phClientHandle ou pLegacyMacAddress a la valeur NULL.
ERROR_NOT_ENOUGH_MEMORY	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.
RPC_STATUS	Différents codes d’erreur.

Remarques

La fonction WFDOpenLegacySession 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 WFDOpenLegacySession ou 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. La fonction WFDOpenLegacySession est utilisée pour récupérer et appliquer un profil stocké pour un appareil hérité Wi-Fi Direct.

La fonction WFDOpenLegacySession récupère le profil hérité stocké pour l’appareil à partir du magasin de profils pour l’adresse d’appareil héritée spécifiée. Cette adresse d’appareil doit être obtenue à partir d’un nœud d’appareil créé à la suite de l’expérience de jumelage de boîte de réception (appairage WPS hérité).

Une fois qu’une application est terminée à l’aide du service direct Wi-Fi, l’application doit appeler la fonction WFDCloseSession pour fermer la session et appeler la fonction WFDCloseHandle pour signaler au Wi-Fi service Direct que l’application est terminé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