EapHostPeerProcessReceivedPacket-Funktion (eappapis.h)

Wird vom Supplicant jedes Mal aufgerufen, wenn das Supplicant ein Paket empfängt, das EAPHost verarbeiten muss. EapHostPeerProcessReceivedPacket sollte erst nach einem erfolgreichen Aufruf von EapHostPeerBeginSession aufgerufen werden.

Syntax

DWORD EapHostPeerProcessReceivedPacket(
  [in]  EAP_SESSIONID             sessionHandle,
  [in]  DWORD                     cbReceivePacket,
  [in]  const BYTE * const        pReceivePacket,
  [out] EapHostPeerResponseAction *pEapOutput,
  [out] EAP_ERROR                 **ppEapError
);

Parameter

[in] sessionHandle

Ein Zeiger auf eine EAP_SESSIONID-Struktur , die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionId-Parameter in einem vorherigen Aufruf von EapHostPeerBeginSession zurückgegeben. sessionHandle kann 0 sein, wenn das Supplicant eine neue Identitätsanforderung empfängt, die keiner Sitzung zugeordnet ist.

[in] cbReceivePacket

Die Größe des empfangenen Paketpuffers in Bytes, auf die der cbReceivePacket-Parameter verweist.

[in] pReceivePacket

Ein Zeiger auf einen Puffer, der die vom Supplicant empfangenen eingehenden EAP-Daten enthält.

[out] pEapOutput

Ein Zeiger auf einen EapHostPeerResponseAction-Wert , der angibt, dass der Supplicant die entsprechende Aktion ausführen sollte. In der Regel ruft das Supplicant entweder eine andere Methode auf EAPHost auf oder handelt selbst.

[out] ppEapError

Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur . Die Adresse sollte vor dem Aufrufen dieser Funktion auf NULL festgelegt werden. Wenn Fehlerdaten verfügbar sind, wird ein Zeiger auf die Adresse einer EAP_ERROR-Struktur empfangen, die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nachdem Sie die Fehlerdaten verwendet haben, geben Sie diesen Arbeitsspeicher frei, indem Sie EapHostPeerFreeEapError aufrufen.

Rückgabewert

Keine

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile eappapis.h
Bibliothek Eappprxy.lib
DLL Eappprxy.dll

Weitere Informationen

EAPHost Supplicant Laufzeitfunktionen