EapHostPeerProcessReceivedPacket function

Is called by the supplicant every time the supplicant receives a packet that EAPHost needs to process. EapHostPeerProcessReceivedPacket should be called only after a successful call to EapHostPeerBeginSession.


DWORD WINAPI EapHostPeerProcessReceivedPacket(
  _In_   EAP_SESSIONID sessionHandle,
  _In_   DWORD cbReceivePacket,
  _In_   const BYTE *pReceivePacket,
  _Out_  EapHostPeerResponseAction *pEapOutput,
  _Out_  EAP_ERROR **ppEapError


sessionHandle [in]

A pointer to an EAP_SESSIONID structure that contains the unique handle for this EAP authentication session on the EAPHost server. This handle is returned in the pSessionId parameter in a previous call to EapHostPeerBeginSession. sessionHandle can be zero if the supplicant receives a new identity request not associated with any session.

cbReceivePacket [in]

The size, in bytes, of the received packet buffer pointed to by the cbReceivePacket parameter.

pReceivePacket [in]

A pointer to a buffer that contains the incoming EAP data received by the supplicant.

pEapOutput [out]

A pointer to an EapHostPeerResponseAction value that indicates the supplicant should take appropriate action. Typically the supplicant either calls another method on EAPHost or acts on its own.

ppEapError [out]

A pointer to the address of an EAP_ERROR structure. The address should be set to NULL before calling this function. If error data is available, a pointer to the address of an EAP_ERROR structure that contains any errors raised during the execution of this function call is received. After using the error data, free this memory by calling EapHostPeerFreeEapError.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]







See also

EAPHost Supplicant Run-time Functions



Community Additions

© 2015 Microsoft