IEAPProviderConfig::Initialize-Methode (rrascfg.h)

Artikel
08/25/2023

Das System ruft die Initialize-Methode auf, um eine EAP-Konfigurationssitzung mit dem angegebenen Computer zu initialisieren.

Syntax

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

Parameter

pszMachineName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Computers enthält, auf dem EAP konfiguriert werden soll. Die Zeichenfolgenlänge ist nicht begrenzt.

dwEapTypeId

Gibt den EAP an, für den eine Konfigurationssitzung initialisiert werden soll.

puConnectionParam

Zeiger auf eine ganzzahlige Variable ohne Vorzeichen. Bei erfolgreicher Rückgabe identifiziert der Wert dieser Variablen diese Konfigurationssitzung.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte der Rückgabewert S_OK werden.

Wenn die Funktion fehlschlägt, sollte der Rückgabewert einer der folgenden Codes sein.

Rückgabecode	Beschreibung
E_FAIL	Nicht spezifischer Fehler.
E_INVALIDARG	Eines der Argumente ist ungültig.
E_OUTOFMEMORY	Bei der Methode ist ein Fehler aufgetreten, da der erforderliche Arbeitsspeicher nicht zugeordnet werden konnte.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Die Konfigurationsoberfläche sollte es dem Benutzer ermöglichen, den EAP-Anbieter auf einem Remotecomputer zu konfigurieren. Stellen Sie während des Aufrufs von Initialize die Verbindung mit dem Remotecomputer her.

Die DLL, die IEAPProviderConfig implementiert, kann mehrere Authentifizierungsprotokolle unterstützen. Der dwEapTypeId-Parameter gibt das Authentifizierungsprotokoll an, für das eine Konfigurationssitzung initialisiert werden soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rrascfg.h