structure PPP_EAP_INFO (raseapif.h)

Article
08/25/2023

La structure PPP_EAP_INFO fournit des informations au Gestionnaire des connexions sur le protocole d’authentification, y compris des pointeurs vers des fonctions situées dans la DLL EAP.

Syntaxe

typedef struct _PPP_EAP_INFO {
  DWORD  dwSizeInBytes;
  DWORD  dwEapTypeId;
  DWORD( )(BOOL fInitialize) *RasEapInitialize;
  DWORD(VOID **ppWorkBuffer,PPP_EAP_INPUT *pPppEapInput) * )(RasEapBegin;
  DWORD()(VOID *pWorkBuffer) * RasEapEnd;
  DWORD(ID *pWorkBuf,PPP_EAP_PACKET *pReceivePacket,PPP_EAP_PACKET *pSendPacket,DWORD cbSendPacket,PPP_EAP_OUTPUT *pEapOutput,PPP_EAP_INPUT *pEapInput) * )(VORasEapMakeMessage;
} PPP_EAP_INFO, *PPPP_EAP_INFO;

Membres

dwSizeInBytes

Spécifie la taille de la structure PPP_EAP_INFO . RAS transmet cette valeur à la DLL EAP. La DLL utilise cette valeur pour déterminer la version de la structure PPP_EAP_INFO RAS utilise.

dwEapTypeId

Spécifie un protocole d’authentification particulier. Cet identificateur doit être unique dans l’implémentation d’EAP à l’échelle du secteur. L’implémenteur d’un protocole d’authentification doit obtenir cet identificateur auprès de l’Autorité IANA (Internet Assigned Numbers Authority).

RasEapInitialize

Pointeur vers la fonction RasEapInitialize pour le protocole d’authentification. Le protocole d’authentification définit la valeur de ce membre. Le protocole d’authentification peut définir ce membre sur NULL, auquel cas le protocole n’exige pas que RAS appelle cette fonction.

fInitialize

Spécifie si le protocole d’authentification doit initialiser ou dé-initialiser. Ce paramètre est TRUE si le protocole s’initialise et FALSE si le protocole ne s’initialise pas.

RasEapBegin

Pointeur vers la fonction RasEapBegin pour le protocole d’authentification demandé. Le protocole d’authentification définit la valeur de ce membre. Ce membre peut être NULL, auquel cas, le protocole d’authentification ne nécessite aucune initialisation. Si ce membre a la valeur NULL, RAS ignore le membre RasEapEnd .

ppWorkBuffer

Pointeur vers un pointeur qui, en cas de retour réussi, pointe vers une mémoire tampon de travail. Cette mémoire tampon est opaque en RAS ; le contenu de la mémoire tampon est utilisé uniquement par le protocole d’authentification. Le gestionnaire de connexions RAS transmet un pointeur vers cette mémoire tampon vers le protocole d’authentification dans les appels suivants à RasEapMakeMessage.

pPppEapInput

Pointeur vers une structure PPP_EAP_INPUT qui spécifie les informations d’initialisation pour la session d’authentification.

RasEapEnd

Pointeur vers la fonction RasEapEnd pour le protocole d’authentification. Le protocole d’authentification définit la valeur de ce membre.

pWorkBuffer

Pointeur vers la mémoire tampon de travail vers free.

RasEapMakeMessage

Pointeur vers la fonction RasEapMakeMessage pour le protocole d’authentification demandé. Le protocole d’authentification définit la valeur de ce membre.

pWorkBuf

Pointeur vers la mémoire tampon de travail. Le protocole d’authentification fournit à RAS un pointeur vers cette mémoire tampon via la fonction RasEapBegin .

pReceivePacket

Pointeur vers une structure PPP_EAP_PACKET qui contient un paquet reçu. Une valeur pReceivePacketnull indique soit que RAS lance le dialogue avec le protocole d’authentification, soit qu’un délai d’expiration s’est produit et que le protocole d’authentification doit renvoyer le dernier paquet. Le protocole d’authentification doit déterminer, en fonction du contexte, lequel de ces deux cas est vrai.

pSendPacket

Pointeur vers une structure PPP_EAP_PACKET . Le protocole d’authentification peut utiliser cette structure pour spécifier un paquet à envoyer.

cbSendPacket

Spécifie la taille, en octets, de la mémoire tampon pointée vers pSendPacket.

pEapOutput

Pointeur vers une structure PPP_EAP_OUTPUT .

pEapInput

Pointeur vers une structure PPP_EAP_INPUT . Ce paramètre peut avoir la valeur NULL.

Remarques

Une DLL EAP donnée peut implémenter plusieurs protocoles d’authentification. Utilisez le membre dwEapTypeId pour spécifier le protocole pour lequel récupérer des informations.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	raseapif.h