EapHostPeerQueryUIBlobFromInteractiveUIInputFields, fonction (eaphostpeerconfigapis.h)

Article
08/23/2023

La fonction EapHostPeerQueryUIBlobFromInteractiveUIInputFields convertit les informations utilisateur en objet BLOB utilisateur qui peut être consommé par les fonctions d’exécution EAPHost.

Syntaxe

DWORD EapHostPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [in, out] DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [in, out] BYTE                          **ppDataFromInteractiveUI,
  [out]     EAP_ERROR                     **ppEapError,
  [in, out] LPVOID                        *ppvReserved
);

Paramètres

[in] dwVersion

Numéro de version de l’API.

Valeur	Signification
EAPHOST_PEER_API_VERSION 1	Version des API d’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 des 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.

[in] 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.

[in, out] pdwSizeOfDataFromInteractiveUI

Pointeur vers un DWORD qui spécifie la taille, en octets, de la mémoire tampon pointée par ppDataFromInteractiveUI. 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 à ppDataFromInteractiveUI.

[in, out] ppDataFromInteractiveUI

Pointeur qui reçoit un objet BLOB d’informations d’identification qui peut être utilisé dans l’authentification. L’appelant doit libérer les pointeurs internes à l’aide de la fonction EapHostPeerFreeMemory, en commençant par le pointeur le plus interne. 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 BLOB non NULL est fournie, la fonction LocalAlloc doit être utilisée.

[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.

[in, out] ppvReserved

Réservé pour un usage futur. Ce paramètre doit être défini sur 0.

Valeur de retour

None

Remarques

Séquence d’appels d’API de supplicant.

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

Authentification unique et PLAP

Partager via