EapHostPeerQueryInteractiveUIInputFields, fonction (eaphostpeerconfigapis.h)
La fonction EapHostPeerQueryInteractiveUIInputFields obtient les champs d’entrée pour les composants d’interface utilisateur interactifs à lever sur le demandeur.
Syntaxe
DWORD EapHostPeerQueryInteractiveUIInputFields(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
Paramètres
[in] dwVersion
Numéro de version de l’API.
| Valeur | Signification |
|---|---|
|
Version de l’API de l’homologue EAPHost. |
[in] dwFlags
Combinaison d’indicateurs EAP qui décrivent le comportement de la session d’authentification EAP.
[in] dwSizeofUIContextData
Taille des données de contexte dans pUIContextData, en octets.
[in] pUIContextData
Pointeur vers un objet BLOB qui contient des données de contexte d’interface utilisateur, représentées en tant que pointeurs internes vers les données de champ. Ces pointeurs internes doivent être libérés en les passant à EapHostPeerFreeMemory, en commençant par le pointeur le plus interne.
[out] pEapInteractiveUIData
Pointeur qui reçoit une structure de EAP_INTERACTIVE_UI_DATA qui contient des informations de configuration pour les composants d’interface utilisateur interactifs déclenchés sur un demandeur EAP. 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 appelant EapHostPeerFreeErrorMemory.
[in, out] ppvReserved
Réservé pour un usage futur. Ce paramètre doit être défini sur 0.
Valeur de retour
None
Notes
EapHostPeerQueryInteractiveUIInputFields peut être utilisé pour prendre en charge l’authentification unique (SSO). Le demandeur utilise l’indicateur EAP_FLAG_PRE_LOGON dans EapHostPeerBeginSession pour indiquer à EAPHost que l’authentification unique doit être fournie. Si le code d’action EapHostPeerResponseInvokeUI est reçu après avoir appelé EapHostPeerBeginSession, EAPHost appelle eapHostPeerQueryInteractiveUIInputFields, puis appelle eapHostPeerQueryUIBlobFromInteractiveUIInputFields.
Le demandeur doit appeler le EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED est retourné, le demandeur doit recourir au modèle traditionnel d’appel de l’interface utilisateur interactive de méthode en appelant EapHostPeerInvokeInteractiveUI. En cas d’erreur, EapHostPeerQueryInteractiveUIInputFields retourne un code de retour autre que NULL.
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 |