Edit

IEAPProviderConfig::RouterInvokeConfigUI method (rrascfg.h)

  • Article

The system calls the RouterInvokeConfigUI method to invoke the configuration user interface for EAP authentication between two routers.

Syntax

HRESULT RouterInvokeConfigUI(
  DWORD     dwEapTypeId,
  ULONG_PTR uConnectionParam,
  HWND      hwndParent,
  DWORD     dwFlags,
  BYTE      *pConnectionDataIn,
  DWORD     dwSizeOfConnectionDataIn,
  BYTE      **ppConnectionDataOut,
  DWORD     *pdwSizeOfConnectionDataOut
);

Parameters

dwEapTypeId

Specifies the EAP for which to invoke the configuration user interface.

uConnectionParam

Specifies the configuration session for which to invoke the user interface.

hwndParent

Handle to the parent window for the configuration user interface.

dwFlags

Specifies the RAS_EAP_FLAG_ROUTER flag. This is the only valid flag for this parameter. It indicates that authentication is between two routers. This parameter always includes this flag.

pConnectionDataIn

Pointer to the current configuration data for the interface.

dwSizeOfConnectionDataIn

Specifies the size of the current configuration data pointed to by the pConnectionDataIn parameter.

ppConnectionDataOut

Pointer to a pointer to a buffer that contains the new configuration data for the interface.

pdwSizeOfConnectionDataOut

Pointer to a DWORD variable to receive the size of the new configuration data.

Return value

If the function succeeds, the return value should be S_OK.

If the function fails, the return value should be one of the following codes.

Return code Description
E_FAIL
 Non-specific error.
E_INVALIDARG
 One of the arguments is invalid.
E_OUTOFMEMORY
 The method failed because it was unable to allocate required memory.
E_UNEXPECTED
 An unexpected error occurred.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header rrascfg.h

See also

EAP Interfaces

Extensible Authentication Protocol Reference

IEAPProviderConfig

IEAPProviderConfig::Initialize

IEAPProviderConfig::RouterInvokeCredentialsUI

IEAPProviderConfig::ServerInvokeConfigUI

IEAPProviderConfig::Uninitialize