IEAPProviderConfig::Initialize method

The system calls the Initialize method to initialize an EAP configuration session with the specified computer.

Syntax

HRESULT Initialize(
  LPCOLESTR pszMachineName,
  DWORD     dwEapTypeId,
  ULONG_PTR *puConnectionParam
);

Parameters

pszMachineName

Pointer to a null-terminated string that contains the name of the computer on which to configure EAP. String length is not limited.

dwEapTypeId

Specifies the EAP for which to initialize a configuration session.

puConnectionParam

Pointer to an unsigned integer variable. On successful return, the value of this variable identifies this configuration session.

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.

Remarks

The configuration UI should allow the user to configure the EAP provider on a remote computer. Establish the connection to the remote computer during the call to Initialize.

The DLL that implements IEAPProviderConfig can support more than one authentication protocol. The dwEapTypeId parameter specifies the authentication protocol to initialize a configuration session for.

Requirements

   
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::RouterInvokeConfigUI

IEAPProviderConfig::RouterInvokeCredentialsUI

IEAPProviderConfig::ServerInvokeConfigUI

IEAPProviderConfig::Uninitialize