EapHostPeerGetAuthStatus

EapHostPeerGetAuthStatus function

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

authParam [in]

An EapHostPeerAuthParams enumeration value that specifies the type of EAP authentication data to obtain from EAPHost.

ValueMeaning
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: ppAuthData contains a EapHostPeerNapInfo structure.

 

pcbAuthData [out]

The size, in bytes, of the EAP authentication data buffer pointed to by the ppAuthData parameter.

ppAuthData [out]

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

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

 

 

Community Additions

ADD
Show:
© 2016 Microsoft