Platform SDK: RAS/Routing and RAS

RasInvokeEapUI

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

DWORD RasInvokeEapUI(
  HRASCONN hRasConn,  // handle to connection
  DWORD dwSubEntry,   // subentry from callback
  LPRASDIALEXTENSIONS lpExtensions,  
  HWND hwnd           // handle to parent window for user interface
);

Parameters

hRasConn: Handle to the connection returned by RasDial.
dwSubEntry: Specifies the subentry returned in the callback.
lpExtensions: Pointer to a RASDIALEXTENSIONS structure. This structure should be the same as that passed to RasDial when restarting from a paused state. The dwSize member of the RASDIALEXTENSIONS structure must be set to sizeof(RASDIALEXTENSIONS). This parameter cannot be NULL.
hwnd: Handle to the parent window to use when displaying the EAP user interface.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value	Meaning
ERROR_INVALID_HANDLE	The hRassConn 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

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Ras.h.
  Library: Use Rasapi32.lib.

RasInvokeEapUI

Parameters

Return Values

Requirements

See Also