IEAPProviderConfig::Initialize method (rrascfg.h)

Article
02/22/2024

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

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