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