EapPeerQueryUserBlobFromCredentialInputFields, fonction (eapmethodpeerapis.h)

La fonction EapPeerQueryUserBlobFromCredentialInputFields définit l’implémentation d’une fonction de méthode EAP qui obtient les données BLOB utilisateur fournies dans une interface utilisateur interactive d’authentification unique (SSO) déclenchée sur le demandeur.

Syntaxe

DWORD EapPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      BYTE                               *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [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

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

Taille des données 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 de l’authentification unique EAP.

[in] pEapConfigInputFieldArray

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

[in, out] pdwUserBlobSize

Pointeur vers une mémoire tampon qui contient la taille, en octets, des données BLOB de configuration utilisateur opaques dans ppUserBlob.

[in, out] ppbUserBlob

Pointeur qui contient l’objet BLOB de données utilisateur opaques.

[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

Notes

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

Après EapPeerQueryUserBlobFromCredentialInputFields, EAPHost appelle EapPeerBeginSession. Le demandeur utilise l’indicateur EAP_FLAG_PRE_LOGON dans EapHostPeerBeginSession pour indiquer qu’EAPHost doit fournir l’authentification unique.

Spécifications

Voir aussi

EAP_CONFIG_INPUT_FIELD_ARRAY

Authentification unique et PLAP