EapHostPeerGetIdentity, fonction (eappapis.h)

Cette fonction est appelée par les méthodes de tunnel pour demander des informations d’identité aux méthodes internes. Cette fonction retourne les informations d’identité et d’informations d’identification de l’utilisateur.

Syntaxe

DWORD EapHostPeerGetIdentity(
  [in]      DWORD           dwVersion,
  [in]      DWORD           dwFlags,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in]      HANDLE          hTokenImpersonateUser,
  [out]     BOOL            *pfInvokeUI,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] BYTE            **ppvReserved
);

Paramètres

[in] dwVersion

Numéro de version de l’API. Doit être défini sur zéro.

[in] dwFlags

Combinaison d’indicateurs EAP qui décrivent le comportement de la session d’authentification EAP.

[in] eapMethodType

Structure EAP_METHOD_TYPE qui spécifie le type d’authentification EAP à utiliser pour cette session.

[in] dwSizeofConnectionData

Taille de la mémoire tampon indiquée par le paramètre pConnectionData , en octets.

[in] pConnectionData

Pointeur vers les données de configuration utilisées pour la méthode EAP.

[in] dwSizeofUserData

Taille de la mémoire tampon indiquée par le paramètre pUserData , en octets.

[in] pUserData

Pointeur vers les informations d’identification de l’utilisateur qui se rapportent à cette session d’authentification.

[in] hTokenImpersonateUser

Jeton d’emprunt d’identité pour un utilisateur connecté afin de collecter des informations relatives à l’utilisateur.

[out] pfInvokeUI

Retourne TRUE si l’identité utilisateur et l’objet blob de données utilisateur ne sont pas retournés correctement, et si la méthode cherche à collecter les informations de l’utilisateur via la boîte de dialogue d’interface utilisateur.

[in, out] pdwSizeOfUserDataOut

Taille de la mémoire tampon indiquée par le paramètre ppUserDataOut , en octets.

[out] ppUserDataOut

Informations de données utilisateur retournées par la méthode . Après utilisation, cette mémoire doit être libérée en appelant EapHostPeerFreeRuntimeMemory.

[out] ppwszIdentity

Pointeur vers une chaîne d’identité utilisateur terminée par null. Après utilisation, cette mémoire doit être libérée en appelant EapHostPeerFreeRuntimeMemory.

[out] ppEapError

Pointeur vers un pointeur vers une structure de EAP_ERROR qui contient les erreurs générées pendant l’exécution de cet appel de fonction. Après avoir consommé les données d’erreur, cette mémoire doit être libérée en appelant EapHostPeerFreeErrorMemory.

[in, out] ppvReserved

Paramètres réservés pour un usage ultérieur

Valeur de retour

None

Spécifications

Voir aussi

EAPHost Supplicant Run-Time Functions

EapHostPeerGetUIContext