EapMethodAuthenticatorReceivePacket-Funktion (eapmethodauthenticatorapis.h)

  • Artikel

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

Weitere Informationen

Funktionen der EAPHost Authenticator-Methode

EapMethodAuthenticatorBeginSession