Funzione EapHostPeerProcessReceivedPacket (eappapis.h)

Viene chiamato dal supplicante ogni volta che il supplicante riceve un pacchetto che EAPHost deve elaborare. EapHostPeerProcessReceivedPacket deve essere chiamato solo dopo una chiamata riuscita a EapHostPeerBeginSession.

Sintassi

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

Parametri

[in] sessionHandle

Puntatore a una struttura di EAP_SESSIONID che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost. Questo handle viene restituito nel parametro pSessionId in una chiamata precedente a EapHostPeerBeginSession. sessionHandle può essere zero se il supplicant riceve una nuova richiesta di identità non associata a alcuna sessione.

[in] cbReceivePacket

Dimensioni, in byte, del buffer del pacchetto ricevuto a cui punta il parametro cbReceivePacket .

[in] pReceivePacket

Puntatore a un buffer che contiene i dati EAP in ingresso ricevuti dal supplicante.

[out] pEapOutput

Puntatore a un valore EapHostPeerResponseAction che indica che il supplicante deve intraprendere un'azione appropriata. In genere, il supplicante chiama un altro metodo in EAPHost o agisce autonomamente.

[out] ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR . L'indirizzo deve essere impostato su NULL prima di chiamare questa funzione. Se sono disponibili dati di errore, viene ricevuto un puntatore all'indirizzo di una struttura EAP_ERROR contenente eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver usato i dati di errore, liberare questa memoria chiamando EapHostPeerFreeEapError.

Valore restituito

nessuno

Requisiti

Vedi anche

Funzioni di run-time supplicant di EAPHost