RasInvokeEapUI function

The RasInvokeEapUI function displays a custom user interface to obtain Extensible Authentication Protocol (EAP) information from the user.

Syntax


DWORD RasInvokeEapUI(
  _In_ HRASCONN            hRasConn,
  _In_ DWORD               dwSubEntry,
  _In_ LPRASDIALEXTENSIONS lpExtensions,
  _In_ HWND                hwnd
);

Parameters

hRasConn [in]

Handle to the connection returned by RasDial.

dwSubEntry [in]

Specifies the subentry returned in the callback.

lpExtensions [in]

Pointer to the RASDIALEXTENSIONS structure. This structure should be the same as that passed to RasDial when restarting from a paused state. Ensure that the dwSize member of the RASDIALEXTENSIONS structure specifies the size of the structure. Obtain the size using sizeof(RASDIALEXTENSIONS). This parameter cannot be NULL.

hwnd [in]

Handle to the parent window to use when displaying the EAP user interface.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is one of the following error codes or a value from Routing and Remote Access Error Codes or Winerror.h.

ValueMeaning
ERROR_INVALID_HANDLE

The hRasConn parameter is zero, or the lpExtensions parameter is NULL.

ERROR_INVALID_SIZE

The value of the dwSize member of the RASDIALEXTENSIONS structure specifies a version of the structure that isn't supported by the operating system in use.

Other

Use FormatMessage to retrieve the system error message that corresponds to the error code returned.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ras.h

Library

Rasapi32.lib

DLL

Rasapi32.dll

See also

Remote Access Service (RAS) Overview
Remote Access Service Functions
RasDial
RASDIALEXTENSIONS
RASEAPINFO

 

 

Community Additions

ADD
Show: