EAP_AUTHENTICATOR_METHOD_ROUTINES structure (eapmethodauthenticatorapis.h)

  • Article

Contient un ensemble de pointeurs de fonction vers les API de méthode d’authentification EAPHost.

Syntaxe

typedef struct _EAP_AUTHENTICATOR_METHOD_ROUTINES {
  DWORD           dwSizeInBytes;
  EAP_METHOD_TYPE *pEapType;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorInitialize;
  DWORD(ORD dwFlags,LPCWSTR pwszIdentity, const EapAttributes * const pAttributeArray,DWORD dwSizeofConnectionData, const BYTE * const pConnectionData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)          * )(DWEapMethodAuthenticatorBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwFlags, const WCHAR *pwszIdentity, const EapAttributes * const pAttributeArray,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorUpdateInnerMethodParams;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket, const EapPacket * const pReceivePacket,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorReceivePacket;
  DWORD(P_SESSION_HANDLE sessionHandle,BYTE bPacketId,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,EAP_ERROR **ppEapError)          * )(EAEapMethodAuthenticatorSendPacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle, const EapAttributes * const pAttribs,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorSetAttributes;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EAP_METHOD_AUTHENTICATOR_RESULT *pResult,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetResult;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)          * )EapMethodAuthenticatorEndSession;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorShutdown;
} EAP_AUTHENTICATOR_METHOD_ROUTINES, *PEAP_AUTHENTICATOR_METHOD_ROUTINES;

Membres

dwSizeInBytes

Version de structure définie par l’implémenteur.

Note Les valeurs de ce champ ne sont pas définies par Microsoft.
 

pEapType

Pointeur vers une structure de EAP_METHOD_TYPE qui contient les informations de fournisseur sur l’implémenteur des API pointées par les membres de cette structure.

EapMethodAuthenticatorInitialize

Pointeur de fonction vers EapMethodAuthenticatorInitialize.

pEapType

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

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 passant un pointeur vers les données d’erreur vers EapPeerFreeErrorMemory.

EapMethodAuthenticatorBeginSession

Pointeur de fonction vers EapMethodAuthenticatorBeginSession.

dwFlags

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

pwszIdentity

Chaîne Unicode sans fin qui contient l’identité de l’utilisateur à authentifier.

pAttributeArray

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

dwSizeOfConnectionData

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

pConnectionData

Pointeur vers une mémoire tampon d’octets qui contient les données blob de configuration opaques.

dwMaxSendPacketSize

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

pSessionHandle

Reçoit un pointeur vers une structure de EAP_SESSION_HANDLE qui contient l’ID unique de la nouvelle session d’authentification EAP sur le serveur EAPHost.

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 passant un pointeur vers les données d’erreur vers EapPeerFreeErrorMemory.

EapMethodAuthenticatorUpdateInnerMethodParams

Pointeur de fonction vers EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession

dwFlags

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

pwszIdentity

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

pAttributeArray

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

ppEapError

Pointeur vers l’adresse d’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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorReceivePacket

Pointeur de fonction vers EapMethodAuthenticatorReceivePacket.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession

cbReceivePacket

Taille, en octets, de pReceivePacket.

pReceivePacket

Pointeur vers une structure EapPacket qui contient un paquet de session d’authentification EAP reçu du demandeur par le serveur EAPHost.

pEapOutput

Reçoit un pointeur vers une valeur d’énumération EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION qui indique l’action suivante que le demandeur doit effectuer dans la session d’authentification EAP.

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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorSendPacket

Pointeur de fonction vers EapMethodAuthenticatorSendPacket.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession

bPacketId

Spécifie une valeur d’ID numérique pour le paquet à envoyer.

pcbSendPacket

Spécifie la taille maximale, en octets, du paquet à envoyer. Au retour, ce paramètre reçoit la taille, en octets, du paquet retourné dans pEapPacket.

pSendPacket

Reçoit un pointeur vers une structure EapPacket qui contient le paquet à envoyer au demandeur.

pTimeout

Reçoit un pointeur vers une valeur EAP_AUTHENTICATOR_SEND_TIMEOUT qui spécifie le délai d’expiration du paquet.

ppEapError

Pointeur vers l’adresse d’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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory

EapMethodAuthenticatorGetAttributes

Pointeur de fonction vers EapMethodAuthenticatorGetAttributes.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession

pAttribs

Reçoit un pointeur vers une structure EapAttributes qui contient un tableau d’attributs de réponse d’authentification EAP pour le demandeur.

ppEapError

Pointeur vers l’adresse d’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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory

EapMethodAuthenticatorSetAttributes

Pointeur de fonction vers EapMethodAuthenticatorSetAttributes.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession

pAttribs

Pointeur vers une structure EapAttributes qui contient un tableau de nouveaux attributs de réponse d’authentification EAP à définir pour le demandeur sur EAPHost.

pEapOutput

Reçoit un pointeur vers une valeur d’énumération EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION qui spécifie l’action suggérée que le demandeur doit effectuer en réponse aux attributs mis à jour.

ppEapError

Pointeur vers l’adresse d’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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorGetResult

Pointeur de fonction vers EapMethodAuthenticatorGetResult.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession

pResult

Reçoit un pointeur vers une structure EAP_METHOD_AUTHENTICATOR_RESULT qui contient les résultats de l’authentification.

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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorEndSession

Pointeur de fonction vers EapMethodAuthenticatorEndSession.

sessionHandle

EAP_SESSION_HANDLE valeur qui contient le handle spécifique pour la session d’authentification EAP à fermer sur le serveur EAPHost. Ce handle est obtenu par un appel précédent à EapMethodAuthenticatorBeginSession.

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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorShutdown

Pointeur de fonction vers EapMethodAuthenticatorShutdown.

pEapType

Une valeur d’énumération EAP_METHOD_TYPE qui spécifie le type d’authentification EAP utilisée dans la session.

ppEapError

Pointeur vers l’adresse d’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 passant un pointeur vers les données d’erreur vers EapMethodAuthenticatorFreeErrorMemory.

Notes

Chaque DLL de méthode d’authentificateur EAP doit avoir des implémentations publiques des API suivantes.

Ces API sont appelées sur une méthode d’authentificateur EAP lorsqu’un authentificateur (serveur) EAPHost reçoit un appel de procédure distante spécifique correspondant d’une méthode EAP homologue (client). Notez qu’il n’existe pas de correspondance un-à-un complète entre les méthodes d’homologue EAP et les méthodes d’authentificateur EAP ; les appels d’API de méthode d’authentificateur EAP spécifiques doivent être effectués en fonction des exigences de votre implémentation des appels d’API de méthode d’authentificateur EAP.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête eapmethodauthenticatorapis.h

Voir aussi

Structures de méthode EAPHost Authenticator

EapMethodAuthenticatorGetInfo