EapMethodAuthenticatorBeginSession, fonction (eapmethodauthenticatorapis.h)

Article
02/26/2024

Crée une session d’authentification EAP sur le serveur EAPHost.

EapMethodAuthenticatorBeginSession est un prototype de fonction.

Syntaxe

DWORD EapMethodAuthenticatorBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  BYTE                        bInitialId,
        LPCWSTR                     pwszIdentity,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  DWORD                       dwSizeofConnectionData,
        const BYTE * const          pConnectionData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Paramètres

[in] dwFlags

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

[in] bInitialId

Chaîne Unicode terminée à zéro qui contient l’identité de l’utilisateur à authentifier.

pwszIdentity

Identité de l’utilisateur en cours d’authentification.

[in] pAttributeArray

Pointeur vers une structure de tableau EapAttributes qui spécifie les attributs EAP de l’entité à authentifier.

[in] dwSizeofConnectionData

Spécifie la taille en octets des données pointées par pConnectionData. Si pConnectionData a la valeur NULL, ce membre est égal à zéro.

pConnectionData

Pointeur vers les données de connexion reçues à partir de l’interface utilisateur de configuration du protocole d’authentification.

[in] dwMaxSendPacketSize

Spécifie la taille maximale, en octets, d’un paquet EAP envoyé pendant la session.

[out] pSessionHandle

Pointeur vers une structure de EAP_SESSION_HANDLE qui contient le handle unique pour cette session d’authentification EAP sur le serveur EAPHost.

[out] ppEapError

Reçoit éventuellement un 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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeMemory.

Valeur de retour

None

Remarques

Cet appel est effectué par un EAPHost basé sur l’authentificateur à l’aide d’un pointeur de fonction vers cette API. Cette API doit être implémentée sur la méthode d’authentificateur EAP chargée par EAPHost, et doit être strictement conforme à la syntaxe et aux types de paramètres spécifiés dans la documentation.

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	eapmethodauthenticatorapis.h

Voir aussi

EapHost Authenticator, fonctions de méthode

EapHostPeerBeginSession

Partager via