EapPeerQueryInteractiveUIInputFields, fonction (eapmethodpeerapis.h)
La fonction EapPeerQueryInteractiveUIInputFields définit l’implémentation d’une API de méthode EAP qui fournit les champs d’entrée pour les composants d’interface utilisateur interactifs à lever sur le demandeur.
Syntaxe
DWORD EapPeerQueryInteractiveUIInputFields(
[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. Doit être défini sur zéro.
[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 sous la forme de pointeurs internes vers des données de champ. Le demandeur a obtenu ces pointeurs internes à partir des API d’exécution EAPHost.
[out] pEapInteractiveUIData
Pointeur qui reçoit une structure EAP_INTERACTIVE_UI_DATA qui contient des informations de configuration pour les composants d’interface utilisateur interactifs déclenchés sur un demandeur EAP.
[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.
[in, out] ppvReserved
Réservé pour un usage ultérieur. Doit être défini sur NULL
Valeur de retour
None
Remarques
EapPeerQueryInteractiveUIInputFields peut être utilisé pour prendre en charge l’authentification unique (SSO). L’indicateur EAP_FLAG_PRE_LOGON dans EapPeerBeginSession indique à EAPHost que l’authentification unique doit être fournie. Si le code d’action EapPeerResponseInvokeUI est reçu après l’appel d’EapPeerBeginSession, EAPHost appelle EapPeerQueryInteractiveUIInputFields, puis appelle EapPeerQueryUIBlobFromInteractiveUIInputFields.
Le demandeur doit appeler toujours le EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED est retourné, le demandeur doit recourir au modèle traditionnel d’interface utilisateur interactive de méthode d’appel en appelant EapPeerInvokeInteractiveUI. En cas d’erreur, EapPeerQueryInteractiveUIInputFields retourne un code de retour autre que NULL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |