RasInvokeEapUI function

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

Syntax

DWORD RasInvokeEapUI(
  HRASCONN            ,
  DWORD               ,
  LPRASDIALEXTENSIONS ,
  HWND                
);

Parameters

arg1

Handle to the connection returned by RasDial.

arg2

Specifies the subentry returned in the callback.

arg3

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.

arg4

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.

Value Meaning
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]
Target Platform Windows
Header ras.h
Library Rasapi32.lib
DLL Rasapi32.dll

See Also

RASDIALEXTENSIONS

RASEAPINFO

RasDial

Remote Access Service (RAS) Overview

Remote Access Service Functions