EapHostPeerGetAuthStatus function (eappapis.h)

Obtains the supplicant's current EAP authentication status from EAPHost.

Syntax

DWORD EapHostPeerGetAuthStatus(
  EAP_SESSIONID         sessionHandle,
  EapHostPeerAuthParams authParam,
  DWORD                 *pcbAuthData,
  BYTE                  **ppAuthData,
  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.

Value Meaning
EapHostPeerAuthStatus
ppAuthData contains a EAPHOST_AUTH_INFO structure.
EapHostPeerIdentity
ppAuthData contains a WCHAR buffer.
EapHostPeerIdentityExtendedInfo
ppAuthData contains a CHAR buffer.
EapHostNapInfo
Windows 7 or later: [EapHostPeerNapInfo](/windows/win32/eaphost/eaphostpeernapinfo) structure.

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 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.

Return value

None

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header eappapis.h
Library Eappprxy.lib
DLL Eappprxy.dll

See also

EAPHost Supplicant Run-Time Functions