EapPeerInvokeIdentityUI, fonction (eapmethodpeerapis.h)

Article
08/23/2023

Déclenche une boîte de dialogue d’interface utilisateur interactive personnalisée pour obtenir des informations d’identité utilisateur pour la méthode EAP sur le client.

Syntaxe

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

Paramètres

[in] pEapType

Une structure EAP_METHOD_TYPE qui contient des informations sur le fournisseur et l’auteur sur la méthode EAP utilisée pour l’authentification de la connexion.

[in] dwFlags

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

[in] hwndParent

Handle de la fenêtre parente qui génère la boîte de dialogue d’interface utilisateur interactive pour obtenir les données d’identité.

[in] dwSizeOfConnectionData

Taille, en octets, des données de contexte d’interface utilisateur spécifiées par pUIContextData.

[in] pConnectionData

Pointeur vers une mémoire tampon d’octet opaque qui contient les données de connexion.

[out] dwSizeOfUserData

Spécifie la taille, en octets, des données d’identité utilisateur retournées dans dwSizeOfUserData.

[in] pUserData

Pointeur vers les données utilisateur spécifiques à cette authentification utilisée 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 vers laquelle pointe le paramètre ppResult reçu par EapPeerGetResult.

[out] pdwSizeOfUserDataOut

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

[out] ppUserDataOut

Pointeur vers le pointeur des données utilisateur retournées. Les données sont transmises à EapPeerBeginSession en tant qu’entrée pUserData.

[out] ppwszIdentity

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

[out] ppEapError

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. 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 strictement être 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

Fonctions de configuration de méthode homologue EAPHost

EapPeerInvokeIdentityUI

Partager via