IEAPProviderConfig::RouterInvokeCredentialsUI method (rrascfg.h)

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

Syntax

HRESULT RouterInvokeCredentialsUI(
  DWORD     dwEapTypeId,
  ULONG_PTR uConnectionParam,
  HWND      hwndParent,
  DWORD     dwFlags,
  BYTE      *pConnectionDataIn,
  DWORD     dwSizeOfConnectionDataIn,
  BYTE      *pUserDataIn,
  DWORD     dwSizeOfUserDataIn,
  BYTE      **ppUserDataOut,
  DWORD     *pdwSizeOfUserDataOut
);

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.

pUserDataIn

Pointer to the current credential data for the interface.

dwSizeOfUserDataIn

Specifies the size of the current credentials data.

ppUserDataOut

Pointer to a pointer to a buffer to receive the new credentials data for the interface.

pdwSizeOfUserDataOut

Pointer to a DWORD variable to receive the size of the new credentials 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 the 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::RouterInvokeConfigUI

IEAPProviderConfig::ServerInvokeConfigUI

IEAPProviderConfig::Uninitialize