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

Voir aussi

EAP_CONFIG_INPUT_FIELD_ARRAY

Authentification unique et PLAP