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.

• EapHostPeerInvokeInteractiveUI, et
• EapHostPeerSetUIContext

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

Voir aussi

EAPHost Supplicant Run-time Functions

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext