EapHostPeerGetResult function

Obtains the authentication result for the specified EAP authentication session.

Syntax


DWORD APIENTRY EapHostPeerGetResult(
  _In_  EAP_SESSIONID                 sessionHandle,
  _In_  EapHostPeerMethodResultReason reason,
  _Out_ EapHostPeerMethodResult       *ppResult,
  _Out_ EAP_ERROR                     **ppEapError
);

Parameters

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.

reason [in]

An EapHostPeerMethodResultReason enumeration value that specifies the reason code for the authentication result returned in ppResult.

ppResult [out]

A pointer to a EapHostPeerMethodResultReason structure that contains the authentication results. EAPHost fills this structure with authentication related information defined in EapHostPeerMethodResult.

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. Supplicants must refer to this parameter to determine if the authentication was successful. After using the error data, free this memory by calling EapHostPeerFreeEapError.

Return value

If the function succeeds, the return value is NO_ERROR. The return value does not indicate if the authentication was successful. Supplicants must refer to the ppEapError parameter to determine the authentication result.

If the function fails, the return value should be an appropriate error code from Winerror.h, Raserror.h, or Mprerror.h.

Remarks

The supplicant calls EapHostPeerGetResult on completion of an authentication, which can occur in any of the following scenarios.

  • A call to EapHostPeerProcessReceivedPacket returned the EapHostPeerResponseResult action code.
  • The client timed out and wants to get the result based on the current state.
  • The supplicant received an alternate result, perhaps from a packet on the lower layer.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Eappapis.h

Library

Eappprxy.lib

DLL

Eappprxy.dll

See also

EAPHost Supplicant Run-time Functions
EapHostPeerProcessReceivedPacket

 

 

Community Additions

ADD
Show: