EapHostPeerInvokeInteractiveUI, fonction (eaphostpeerconfigapis.h)

Article
02/28/2024

Déclenche une interface utilisateur interactive utilisée pour obtenir les informations d’identification de l’utilisateur. Par exemple, cette fonction peut être utilisée pour déclencher une interface utilisateur qui récupère les informations d’identification d’un carte intelligent et invite l’utilisateur à entrer le code confidentiel correspondant.

EapHostPeerInvokeInteractiveUI doit être appelé sur les threads dont COM est initialisé pour single threaded Apartment. Pour ce faire, appelez l’API COM CoInitialize ; lorsque le demandeur a terminé avec le thread STA , CoUninitialize doit être appelé avant de quitter.

Syntaxe

DWORD EapHostPeerInvokeInteractiveUI(
  [in]  HWND       hwndParent,
  [in]  DWORD      dwSizeofUIContextData,
  [in]  const BYTE *pUIContextData,
  [out] DWORD      *pdwSizeOfDataFromInteractiveUI,
  [out] BYTE       **ppDataFromInteractiveUI,
  [out] EAP_ERROR  **ppEapError
);

Paramètres

[in] hwndParent

Handle de la fenêtre parente sous laquelle la boîte de dialogue de configuration s’affiche.

[in] dwSizeofUIContextData

Taille, en octets, de la mémoire tampon pointée par le paramètre pUIContextData .

[in] pUIContextData

Pointeur vers une mémoire tampon qui contient les données de contexte d’interface utilisateur d’EAPHost. Les données de contexte sont retournées par EapHostPeerGetUIContext. La mémoire tampon est de taille dwSizeOfUIContextData.

[out] pdwSizeOfDataFromInteractiveUI

Pointeur vers un DWORD qui représente la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre ppDataFromInteractiveUI .

[out] ppDataFromInteractiveUI

Pointeur vers un pointeur vers une mémoire tampon d’octets qui contient les données de l’interface utilisateur interactive nécessaires à la poursuite de l’authentification. Le paramètre ppDataFromInteractiveUI doit être passé à EapHostPeerSetUIContext en tant que paramètre IN pUIContextData. Après avoir consommé les données, cette mémoire doit être libérée en appelant EapHostPeerFreeMemory. La mémoire tampon est de taille pdwSizeofDataFromInteractiveUI.

[out] ppEapError

Pointeur vers un pointeur vers une structure 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

Remarques

Le demandeur doit appeler 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 EapHostPeerInvokeInteractiveUI.

Si elle est appelée, EapHostPeerInvokeInteractiveUI déclenche l’interface utilisateur pour la méthode EAP après que le demandeur a appelé EapHostPeerGetUIContext. Cela se produit lorsqu’un appel à EapHostPeerProcessReceivedPacket renvoie le code d’action EapHostPeerResponseInvokeUi . EapHostPeerGetUIContext retourne le contexte d’interface utilisateur que le demandeur transmet ensuite à EapHostPeerInvokeInteractiveUI pour déclencher l’interface utilisateur.

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	eaphostpeerconfigapis.h
Bibliothèque	Eappcfg.lib
DLL	Eappcfg.dll

Voir aussi

Fonctions de configuration des supplicants EAPHost

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext

Partager via