EapHostPeerProcessReceivedPacket (Compact 2013)
3/26/2014
This function is called by the supplicant every time that the supplicant receives a packet that EAPHost has to process. EapHostPeerProcessReceivedPacket should be called only after a successful call to EapHostPeerBeginSession.
Syntax
DWORD WINAPI EapHostPeerProcessReceivedPacket(
__in EAP_SESSIONID sessionHandle,
__in DWORD cbReceivePacket,
__in const BYTE* pReceivePacket,
__out EapHostPeerResponseAction* pEapOutput,
__out EAP_ERROR** ppEapError
);
Parameters
- sessionHandle
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
The size, in bytes, of the received packet buffer pointed to by the cbReceivePacket parameter.
- pReceivePacket
A pointer to a buffer that contains the incoming EAP data that is received by the supplicant.
- pEapOutput
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
A pointer to the address of an EAP_ERROR structure. The address should be set to NULL before the code calls 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.