EapHostPeerInvokeIdentityUI, fonction (eaphostpeerconfigapis.h)

Cette fonction est appelée par les méthodes tunnel pour appeler l’interface utilisateur d’identité des méthodes internes. Cette fonction retourne l’identité ainsi que les informations d’identification à utiliser pour démarrer l’authentification.

Syntaxe

DWORD EapHostPeerInvokeIdentityUI(
  [in]      DWORD           dwVersion,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwFlags,
  [in]      HWND            hwndParent,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [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] eapMethodType

Structure EAP_METHOD_TYPE qui spécifie le type d’authentification EAP à utiliser pour cette session.

[in] dwFlags

Combinaison d’indicateurs EAP qui décrivent le comportement de la session d’authentification EAP.

[in] hwndParent

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

[in] dwSizeofConnectionData

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

[in] pConnectionData

Pointeur vers les données de configuration utilisées pour la méthode EAP.

[in] dwSizeofUserData

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

[in] pUserData

Pointeur vers les informations d’identification de l’utilisateur qui se rapportent à cette authentification.

[in, out] pdwSizeOfUserDataOut

Taille du jeu de mémoires tampons pour recevoir les données utilisateur retournées par le paramètre ppUserDataOut , en octets.

[out] ppUserDataOut

Pointeur vers un pointeur vers une mémoire tampon qui contient les informations de données utilisateur retournées par la méthode. Après utilisation, cette mémoire doit être libérée en appelant EapHostPeerFreeMemory.

[out] ppwszIdentity

Pointeur vers une chaîne d’identité utilisateur terminée par null. Après utilisation, cette mémoire doit être libérée en appelant EapHostPeerFreeMemory.

[out] ppEapError

Pointeur vers un pointeur vers 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 appelant EapHostPeerFreeErrorMemory.

[in, out] ppvReserved

Réservé pour un usage futur.

Valeur de retour

None

Configuration requise

Voir aussi

Fonctions de configuration EAPHost Supplicant