WFD_OPEN_SESSION_COMPLETE_CALLBACK fonction de rappel (wlanapi.h)

Article
03/04/2024

La fonction WFD_OPEN_SESSION_COMPLETE_CALLBACK définit la fonction de rappel appelée par la fonction WFDStartOpenSession une fois l’opération WFDStartOpenSession terminée.

Syntaxe

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

Paramètres

[in] hSessionHandle

Un handle de session vers une session directe Wi-Fi. Il s’agit d’un handle de session précédemment retourné par la fonction WFDStartOpenSession .

[in] pvContext

Pointeur de contexte passé à la fonction de rappel de la fonction WFDStartOpenSession .

[in] guidSessionInterface

GUID d’interface de l’interface réseau locale sur laquelle cette Wi-Fi appareil Direct a une session ouverte. Ce paramètre est utile si les protocoles de couche supérieure doivent déterminer l’interface réseau à laquelle une session direct Wi-Fi est liée. Cette valeur est retournée uniquement si le paramètre dwError est ERROR_SUCCESS.

[in] dwError

Valeur qui spécifie s’il y a eu une erreur lors de l’appel à la fonction WFDStartOpenSession . Si cette valeur est ERROR_SUCCESS, aucune erreur ne s’est produite et l’opération d’ouverture de la session s’est terminée avec succès.

Les autres valeurs suivantes sont possibles :

Valeur	Signification
ERROR_INVALID_PARAMETER	Le paramètre est incorrect. Cette erreur est retournée si le paramètre hClientHandle a la valeur NULL ou n’est pas 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.
ERROR_SERVICE_NOT_ACTIVE	Le service n'a pas été démarré. Cette erreur est retournée si le service de configuration automatique WLAN n’est pas en cours d’exécution.
RPC_STATUS	Divers codes d’erreur RPC et autres. Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

[in] dwReasonCode

Valeur qui spécifie le plus de détails si une erreur s’est produite pendant WFDStartOpenSession.

Valeur de retour

None

Remarques

La fonction WFD_OPEN_SESSION_COMPLETE_CALLBACK 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.

La fonction WFDStartOpenSession démarre une opération asynchrone pour démarrer une connexion à la demande à un appareil direct Wi-Fi spécifique. L’appareil cible Wi-Fi doit avoir déjà été jumelé via l’expérience de jumelage Windows. Lorsque l’opération asynchrone permettant d’effectuer la connexion Wi-FI Direct se termine, la fonction de rappel spécifiée dans le paramètre pfnCallback est appelée.

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