EapHostPeerQueryUserBlobFromCredentialInputFields, fonction (eaphostpeerconfigapis.h)
La fonction EapHostPeerQueryUserBlobFromCredentialInputFields obtient un objet BLOB d’informations d’identification qui peut être utilisé pour démarrer l’authentification à partir de l’entrée utilisateur reçue de l’interface utilisateur de l’authentification unique (SSO).
Syntaxe
DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
[in] HANDLE hUserImpersonationToken,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwFlags,
[in] DWORD dwEapConnDataSize,
[in] const 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
Handle du jeton d’emprunt d’identité utilisateur à utiliser dans cette session.
[in] eapMethodType
Structure EAP_METHOD_TYPE qui spécifie le type d’authentification EAP à utiliser pour cette session.
[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 pConnectionData.
[in] pbEapConnData
Données de connexion utilisées pour la méthode EAP.
[in] pEapConfigInputFieldArray
Un pointeur vers une structure EAP_CONFIG_INPUT_FIELD_ARRAY contient les données de champ d’entrée de l’interface utilisateur. L’appelant doit libérer les pointeurs internes à l’aide de la fonction EapHostPeerFreeMemory, en commençant par le pointeur le plus interne.
[in, out] pdwUserBlobSize
Pointeur vers un DWORD qui spécifie la taille, en octets, de la mémoire tampon pointée par ppbUserBlob. Si cette valeur n’est pas définie sur zéro, un pointeur vers une mémoire tampon de la taille spécifiée dans ce paramètre doit être fourni à ppbUserBlob.
[in, out] ppbUserBlob
Pointeur vers l’objet BLOB d’informations d’identification qui peut être utilisé dans l’authentification. La mémoire doit être libérée en appelant EapHostPeerFreeMemory. Si une valeur non null est fournie pour ce paramètre (ce qui signifie qu’un objet BLOB de données existant lui est passé), l’objet BLOB de données fourni est mis à jour et retourné dans ce paramètre. Si une valeur d’objet BLOB non NULL est fournie, la fonction LocalAlloc doit être utilisée.
[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 appelant EapHostPeerFreeErrorMemory.
Valeur de retour
None
Notes
EapHostPeerQueryUserBlobFromCredentialInputFields prend en charge l’authentification unique. Cette fonction de requête, comme EapHostPeerQueryCredentialInputFields, est utilisée uniquement dans un scénario d’authentification unique.
Après EapHostPeerQueryUserBlobFromCredentialInputFields, EAPHost appelle EapHostPeerBeginSession. 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 | eaphostpeerconfigapis.h |
| Bibliothèque | Eappcfg.lib |
| DLL | Eappcfg.dll |