PPP_EAP_INFO Struktur (raseapif.h)
Die PPP_EAP_INFO-Struktur stellt dem Verbindungs-Manager Informationen zum Authentifizierungsprotokoll bereit, einschließlich Zeigern auf Funktionen, die sich in der EAP-DLL befinden.
Syntax
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;
Member
dwSizeInBytes
Gibt die Größe der PPP_EAP_INFO-Struktur an. RAS übergibt diesen Wert an die EAP-DLL. Die DLL verwendet diesen Wert, um zu bestimmen, welche Version der PPP_EAP_INFO-Struktur von RAS verwendet wird.
dwEapTypeId
Gibt ein bestimmtes Authentifizierungsprotokoll an. Dieser Bezeichner muss während der gesamten branchenweiten Implementierung von EAP eindeutig sein. Der Implementierer eines Authentifizierungsprotokolls muss diesen Bezeichner von der Internet Assigned Numbers Authority (IANA) abrufen.
RasEapInitialize
Zeiger auf die RasEapInitialize-Funktion für das Authentifizierungsprotokoll. Das Authentifizierungsprotokoll legt den Wert dieses Members fest. Das Authentifizierungsprotokoll kann diesen Member auf NULL festlegen. In diesem Fall erfordert das Protokoll nicht, dass RAS diese Funktion aufruft.
fInitialize
Gibt an, ob das Authentifizierungsprotokoll initialisiert oder deinitialisiert werden soll. Dieser Parameter ist TRUE , wenn das Protokoll initialisiert, und FALSE , wenn das Protokoll nicht initialisiert wird.
RasEapBegin
Zeiger auf die RasEapBegin-Funktion für das angeforderte Authentifizierungsprotokoll. Das Authentifizierungsprotokoll legt den Wert dieses Members fest. Dieser Member kann NULL sein. In diesem Fall erfordert das Authentifizierungsprotokoll keine Initialisierung. Wenn dieser Member NULL ist, ignoriert RAS das RasEapEnd-Element .
ppWorkBuffer
Zeiger auf einen Zeiger, der bei erfolgreicher Rückgabe auf einen Arbeitspuffer verweist. Dieser Puffer ist für RAS undurchsichtig. der Inhalt des Puffers wird nur vom Authentifizierungsprotokoll verwendet. Der RAS-Verbindungs-Manager übergibt bei nachfolgenden Aufrufen von RasEapMakeMessage einen Zeiger auf diesen Puffer an das Authentifizierungsprotokoll.
pPppEapInput
Zeiger auf eine PPP_EAP_INPUT-Struktur , die Initialisierungsinformationen für die Authentifizierungssitzung angibt.
RasEapEnd
Zeiger auf die RasEapEnd-Funktion für das Authentifizierungsprotokoll. Das Authentifizierungsprotokoll legt den Wert dieses Members fest.
pWorkBuffer
Zeiger auf den zu freigebenden Arbeitspuffer.
RasEapMakeMessage
Zeiger auf die RasEapMakeMessage-Funktion für das angeforderte Authentifizierungsprotokoll. Das Authentifizierungsprotokoll legt den Wert dieses Members fest.
pWorkBuf
Zeiger auf den Arbeitspuffer. Das Authentifizierungsprotokoll stellt RAS über die RasEapBegin-Funktion einen Zeiger auf diesen Puffer bereit.
pReceivePacket
Zeiger auf eine PPP_EAP_PACKET-Struktur , die ein empfangenes Paket enthält. Ein pReceivePacket-Wert von NULL gibt an, dass RAS den Dialog mit dem Authentifizierungsprotokoll initiiert oder dass ein Timeout aufgetreten ist und das Authentifizierungsprotokoll das letzte Paket erneut senden soll. Das Authentifizierungsprotokoll muss basierend auf dem Kontext bestimmen, welcher dieser beiden Fälle wahr ist.
pSendPacket
Zeiger auf eine PPP_EAP_PACKET-Struktur . Das Authentifizierungsprotokoll kann diese Struktur verwenden, um ein zu sendende Paket anzugeben.
cbSendPacket
Gibt die Größe des Puffers in Bytes an, auf den pSendPacket verweist.
pEapOutput
Zeiger auf eine PPP_EAP_OUTPUT-Struktur .
pEapInput
Zeiger auf eine PPP_EAP_INPUT-Struktur . Dieser Parameter kann NULL sein.
Hinweise
Eine bestimmte EAP-DLL kann mehr als ein Authentifizierungsprotokoll implementieren. Verwenden Sie das dwEapTypeId-Element , um anzugeben, für welches Protokoll Informationen abgerufen werden sollen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | raseapif.h |