Partager via


EapHostPeerGetUIContext, fonction (eappapis.h)

Obtient le contexte d’interface utilisateur du demandeur auprès d’EAPHost si l’interface utilisateur doit être déclenchée.

EAPHostPeerGetUIContext est toujours suivi des fonctions suivantes.

Syntaxe

DWORD EapHostPeerGetUIContext(
  [in]  EAP_SESSIONID sessionHandle,
  [out] DWORD         *pdwSizeOfUIContextData,
  [out] BYTE          **ppUIContextData,
  [out] EAP_ERROR     **ppEapError
);

Paramètres

[in] sessionHandle

Pointeur vers une structure EAP_SESSIONID qui contient le handle unique pour cette session d’authentification EAP sur le serveur EAPHost. Ce handle est retourné dans le paramètre pSessionId dans un appel précédent à EapHostPeerBeginSession.

[out] pdwSizeOfUIContextData

Pointeur vers une valeur qui spécifie la taille, en octets, de la mémoire tampon de données de contexte d’interface utilisateur retournée dans ppUIContextData.

[out] ppUIContextData

Pointeur vers un pointeur vers une mémoire tampon qui contient les données de contexte d’interface utilisateur d’EAPHost. L’adresse pointée par ce paramètre est passée à EapHostPeerInvokeInteractiveUI en tant que paramètre IN pUIContextData.

[out] ppEapError

Pointeur vers l’adresse d’une structure de EAP_ERROR . L’adresse doit être définie sur NULL avant d’appeler cette fonction. Si des données d’erreur sont disponibles, un pointeur vers l’adresse d’une structure de EAP_ERROR qui contient les erreurs générées pendant l’exécution de cet appel de fonction est reçu. Après avoir utilisé les données d’erreur, libérez cette mémoire en appelant EapHostPeerFreeEapError.

Valeur de retour

None

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête eappapis.h
Bibliothèque Eappprxy.lib
DLL Eappprxy.dll

Voir aussi

EAPHost Supplicant Run-time Functions

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext