EapHostPeerQueryCredentialInputFields, fonction (eaphostpeerconfigapis.h)

Permet à l’utilisateur de déterminer quel type d’informations d’identification sont requises par les méthodes pour effectuer l’authentification dans un scénario d’authentification unique (SSO).

Syntaxe

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

Paramètres

[in] hUserImpersonationToken

Handle du jeton d’emprunt d’identité utilisateur à utiliser dans cette session.

[in] eapMethodType

Structure EAP_METHOD_TYPE qui identifie la méthode EAP que le demandeur doit utiliser.

[in] dwFlags

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

[in] dwEapConnDataSize

Taille, en octets, de la mémoire tampon de données de connexion fournie dans pbEapConnData.

[in] pbEapConnData

Données de connexion utilisées pour la méthode EAP.

[out] pEapConfigInputFieldArray

Pointeur vers une structure EAP_METHOD_INFO_ARRAY pour les méthodes EAP installées. L’appelant doit libérer les pointeurs internes à l’aide de la fonction EapHostPeerFreeMemory, en commençant par le pointeur le plus interne.

[out] ppEapError

Pointeur vers un pointeur vers une structure de EAP_ERROR qui contient les erreurs générées par EAPHost 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 EapHostPeerFreeErrorMemory.

Valeur de retour

None

Notes

EapHostPeerQueryCredentialInputFields prend en charge l’authentification unique (SSO). Cette fonction de requête, comme EapHostPeerQueryUserBlobFromCredentialInputFields, est utilisée uniquement dans un scénario d’authentification unique.

EapHostPeerQueryCredentialInputFields obtient les champs à afficher dans l’interface utilisateur pendant la session. Les champs d’entrée sont obtenus pour afficher les données entrées par l’utilisateur dans l’interface utilisateur de l’authentification unique. La structure EAP_CONFIG_INPUT_FIELD_ARRAY retournée contient des détails sur l’affichage des champs d’entrée.

Après EapHostPeerQueryCredentialInputFields, EAPHost appelle EapHostPeerQueryUserBlobFromCredentialInputFields.

Spécifications

Voir aussi

Fonctions de configuration EAPHost Supplicant

Authentification unique et PLAP