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