EapMethodAuthenticatorReceivePacket-Funktion (eapmethodauthenticatorapis.h)
Verarbeitet ein vom Server EAPHost empfangenes EAP-Authentifizierungspaket und gibt eine Antwortaktion zurück.
EapMethodAuthenticatorReceivePacket ist ein Funktionsprototyp.
Syntax
DWORD EapMethodAuthenticatorReceivePacket(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] DWORD cbReceivePacket,
[in] const EapPacket * const pReceivePacket,
[out] EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] sessionHandle
Ein Zeiger auf eine EAP_SESSION_HANDLE Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionHandle-Parameter in einem vorherigen Aufruf von EapMethodAuthenticatorBeginSession zurückgegeben.
[in] cbReceivePacket
Die Größe von pReceivePacket in Bytes.
[in] pReceivePacket
Ein Zeiger auf eine EapPacket-Struktur , die ein EAP-Authentifizierungssitzungspaket enthält, das vom Supplicant vom Server EAPHost empfangen wurde.
[out] pEapOutput
Ein Zeiger auf eine EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION-Enumeration , die die nächste Aktion angibt, die der Bittsteller in der EAP-Authentifizierungssitzung ausführen muss.
[out] ppEapError
Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost während der Ausführung dieses Funktionsaufrufs ausgelöst werden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapMethodAuthenticatorFreeErrorMemory übergeben wird.
Rückgabewert
Keine
Bemerkungen
Dieser Aufruf wird von einem Authentifikator-basierten EAPHost ausgeführt, der einen Funktionszeiger auf diese API verwendet. Diese API muss für die von EAPHost geladene EAP-Authentifikatormethode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eapmethodauthenticatorapis.h |