EapPeerQueryUIBlobFromInteractiveUIInputFields, fonction (eapmethodpeerapis.h)

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

Syntaxe

DWORD EapPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [out]     BYTE                          **ppDataFromInteractiveUI,
  [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 le paramètre 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 fonctions d’exécution EAPHost.

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

[out] pdwSizeOfDataFromInteractiveUI

Pointeur vers un DWORD qui spécifie la taille de la mémoire tampon vers laquelle pointe le paramètre ppDataFromInteractiveUI , en octets. Si cette valeur n’est pas définie sur 0, un pointeur vers une mémoire tampon de la taille spécifiée dans ce paramètre doit être fourni dans le paramètre ppDataFromInteractiveUI .

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

[out] ppEapError

Pointeur vers l’adresse d’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 EapPeerFreeErrorMemory.

[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 de l’API peer method.

Configuration requise

Voir aussi

Fonctions de configuration des supplicants EAPHost

Authentification unique et PLAP