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