EapPeerQueryCredentialInputFields, fonction (eapmethodpeerapis.h)

Article
03/04/2024

Définit l’implémentation d’une fonction spécifique à une méthode EAP qui obtient les champs d’entrée d’informations d’identification d’authentification unique (SSO) EAP pour une méthode EAP.

Syntaxe

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [out] EAP_ERROR                    **ppEapError
);

Paramètres

[in] hUserImpersonationToken

Jeton d’emprunt d’identité pour l’utilisateur dont les informations d’identification doivent être demandées et obtenues.

[in] eapMethodType

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] dwEapConnDataSize

Taille des données d’octet de configuration de l’authentification unique EAP pointées par pbEapConnData, en octets.

[in] pbEapConnData

Pointeur vers une mémoire tampon d’octets opaque qui contient l’objet BLOB de données de configuration EAP.

[out] pEapConfigFieldsArray

Pointeur vers une structure EAP_CONFIG_INPUT_FIELD_ARRAY qui contient les champs d’entrée à afficher à l’utilisateur demandeur. Les champs pwszData dans les éléments EAP_CONFIG_INPUT_FIELD_DATA individuels sont initialisés sur NULL.

[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 passant un pointeur vers les données d’erreur vers EapPeerFreeErrorMemory.

Valeur de retour

None

Remarques

EapPeerQueryCredentialInputFields prend en charge l’authentification unique. Cette fonction de méthode homologue, comme EapPeerQueryUserBlobFromCredentialInputFields, est utilisée uniquement dans un scénario d’authentification unique.

L’implémentation spécifique à la méthode EAP de cette fonction est appelée par EAPHost chaque fois qu’une application suppliante appelle EapHostPeerQueryCredentialInputFields. L’implémenteur de cette fonction est chargé de s’assurer que la EAP_CONFIG_INPUT_FIELD_ARRAY retournée par cette fonction contient des définitions de champs d’entrée pour chaque élément de données d’informations d’identification que les méthodes EAP demanderont à l’utilisateur demandeur.

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

Voir aussi

EAP_CONFIG_INPUT_FIELD_ARRAY

Authentification unique et PLAP

Partager via