EapPeerGetIdentity, fonction (eapmethodpeerapis.h)

Article
08/23/2023

Retourne les données utilisateur et l’identité de l’utilisateur après avoir été appelé par EAPHost.

Syntaxe

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [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
);

Paramètres

[in] dwFlags

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

[in] dwSizeofConnectionData

Spécifie la taille, en octets, de la mémoire tampon de données de connexion fournie dans pConnectionData

[in] pConnectionData

Pointeur vers une mémoire tampon d’octets qui contient les données blob de configuration opaques.

[in] dwSizeofUserData

Spécifie la taille, en octets, de la mémoire tampon de données utilisateur fournie dans pUserData.

[in] pUserData

Pointeur vers les données utilisateur spécifiques à cette authentification utilisées pour préremplir les données utilisateur. Lorsque cette API est appelée pour la première fois ou lorsqu’une nouvelle session d’authentification démarre, ce paramètre a la valeur NULL. Sinon, définissez ce paramètre sur le membre pUserData de la structure pointée vers par le paramètre ppResult reçu par EapPeerGetResult.

[in] hTokenImpersonateUser

Spécifie un handle pour le jeton d’emprunt d’identité de l’utilisateur en cours d’authentification. Ce handle est NULL lors de l’authentification de l’ordinateur. En utilisant ce handle, une méthode EAP peut emprunter l’identité de l’utilisateur dans le but d’obtenir des informations spécifiques à l’utilisateur, telles que le nom d’utilisateur, le nom de domaine et les informations d’identification.

[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 de l’interface utilisateur.

[in, out] pdwSizeOfUserDataOut

Spécifie la taille, en octets, de la mémoire tampon ppUserDataOut .

[out] ppUserDataOut

Pointeur vers un pointeur vers les données utilisateur retournées. Les données sont passées à EapPeerBeginSession en tant qu’entrée pUserData.

[out] ppwszIdentity

Pointeur vers l’identité d’utilisateur retournée. Le pointeur est inclus dans le paquet de réponse d’identité et retourné au serveur.

[out] ppEapError

Pointeur vers un EAP_ERROR structure 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 EapPeerFreeErrorMemory.

Valeur de retour

None

Notes

Cet appel est effectué par un EAPHost basé sur un homologue à l’aide d’un pointeur de fonction vers cette API. Cette API doit être implémentée sur la méthode EAP chargée par EAPHost, et doit être strictement conforme aux types de syntaxe et de paramètres spécifiés dans la documentation.

Spécifications


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	eapmethodpeerapis.h

Voir aussi

EAPHost Peer Method Run-Time Functions

EapPeerInvokeIdentityUI

Partager via