EapHostPeerGetAuthStatus (Compact 2013)
3/26/2014
Obtains the supplicant's current EAP authentication status from EAPHost.
Syntax
DWORD APIENTRY EapHostPeerGetAuthStatus(
__in EAP_SESSIONID sessionHandle,
__in EapHostPeerAuthParams authParam,
__out DWORD* pcbAuthData,
__out BYTE** ppAuthData,
__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.
- authParam
An EapHostPeerAuthParams enumeration value that specifies the type of EAP authentication data to obtain from EAPHost; defined in EapHostPeerTypes.h.
- pcbAuthData
The size, in bytes, of the EAP authentication data buffer pointed to by the ppAuthData parameter.
- ppAuthData
A pointer to a pointer to a byte buffer that contains the authentication data from EAPHost. The format of this data depends on the value supplied in authParam.
- 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.