EapPeerBeginSession, fonction (eapmethodpeerapis.h)

Démarre une session d’authentification EAP sur l’homologue EAPHost à l’aide de la méthode EAP.

Syntaxe

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Paramètres

[in] dwFlags

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

[in] pAttributeArray

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

[in] hTokenImpersonateUser

Spécifie un handle pour le jeton d’emprunt d’identité utilisateur à utiliser dans cette session.

[in] dwSizeofConnectionData

Spécifie la taille, en octets, de la mémoire tampon de données de connexion fournie dans pConnectionData.

[in] pConnectionData

Données de connexion spécifiques à cette méthode utilisées pour déterminer les données utilisateur retournées par cette API, où les données utilisateur dépendent de certaines configurations de données de connexion. Lorsque ce paramètre a la valeur NULL , l’implémentation de la méthode doit utiliser les valeurs par défaut pour la connexion.

[in] dwSizeofUserData

Spécifie la taille en octets de la mémoire tampon de données utilisateur fournie dans pUserData.

[in] pUserData

Pointeur vers une mémoire tampon d’octets qui contient l’objet BLOB de données utilisateur opaques.

[in] dwMaxSendPacketSize

Spécifie la taille maximale en octets d’un paquet EAP envoyé pendant la session. Si la méthode doit envoyer un paquet supérieur à la taille maximale, la méthode doit prendre en charge la fragmentation et le réassemblage.

[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

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

Valeur de retour

None

Notes

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

Spécifications

Voir aussi

EAPHost Peer Method Run-Time Functions

EapPeerEndSession

Authentification unique et PLAP