IEAPProviderConfig::Initialize method (rrascfg.h)
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 |
|---|---|
|
Non-specific error. |
|
One of the arguments is invalid. |
|
The method failed because it was unable to allocate required memory. |
|
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 |
See also
Extensible Authentication Protocol Reference
IEAPProviderConfig::RouterInvokeConfigUI
IEAPProviderConfig::RouterInvokeCredentialsUI