RasGetEapUserIdentityA-Funktion (ras.h)

Artikel
11/20/2024

Die RasGetEapUserIdentity Funktion ruft Identitätsinformationen für den aktuellen Benutzer ab. Verwenden Sie diese Informationen, um RasDial- mit einem Telefonbucheintrag aufzurufen, der das Extensible Authentication Protocol (EAP) erfordert.

Syntax

DWORD RasGetEapUserIdentityA(
  [in]  LPCSTR                pszPhonebook,
  [in]  LPCSTR                pszEntry,
  [in]  DWORD                 dwFlags,
  [in]  HWND                  hwnd,
  [out] LPRASEAPUSERIDENTITYA *ppRasEapUserIdentity
);

Parameter

[in] pszPhonebook

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den vollständigen Pfad der Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion das Systemtelefonbuch.

[in] pszEntry

Zeiger auf eine NULL--terminated-Zeichenfolge, die einen vorhandenen Eintragsnamen angibt.

[in] dwFlags

Gibt null oder mehr der folgenden Flags an, die den Authentifizierungsprozess qualifizieren.

Flagge	Bedeutung
RASEAPF_NonInteractive	Gibt an, dass das Authentifizierungsprotokoll keine grafische Benutzeroberfläche anzeigen soll. Wenn dieses Flag nicht vorhanden ist, ist es in Ordnung, dass das Protokoll eine Benutzeroberfläche anzeigt.
RASEAPF_Logon	Gibt an, dass die Benutzerdaten von WinLogon abgerufen werden.
RASEAPF_Preview	Gibt an, dass der Benutzer vor der Auswahl zur Eingabe von Identitätsinformationen aufgefordert werden soll.

[in] hwnd

Behandeln des übergeordneten Fensters für das Benutzeroberflächendialogfeld. Wenn der fInvokeUI Parameter FALSEist, sollte hwndNULLsein.

[out] ppRasEapUserIdentity

Zeiger auf einen Zeiger, der bei erfolgreicher Rückgabe die Adresse der RASEAPUSERIDENTITY- Struktur empfängt, die EAP-Benutzeridentitätsinformationen enthält. RasGetEapUserIdentity weist den Speicherpuffer für die RASEAPUSERIDENTITY- Struktur zu. Geben Sie diesen Speicher frei, indem Sie RasFreeEapUserIdentityaufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und Remotezugriffsfehlercodes oder Winerror.h.

Wert	Bedeutung
E_INVALID_ARG	Der pcbEapUserIdentity Parameter ist NULL.
ERROR_INTERACTIVE_MODE	Die Funktion wurde mit der RASEAPF_NonInteractive-Kennzeichnung aufgerufen. Das Authentifizierungsprotokoll muss jedoch eine Benutzeroberfläche anzeigen, um die erforderlichen Identitätsinformationen vom Benutzer abzurufen.
ERROR_INVALID_FUNCTION_FOR_ENTRY	Entweder ist die Authentifizierungsmethode für diesen Telefonbucheintrag nicht EAP, oder die Authentifizierungsmethode ist EAP, aber das Protokoll verwendet das Standarddialogfeld für Windows NT/Windows 2000-Anmeldeinformationen, um Benutzeridentitätsinformationen abzurufen. In beiden Fällen muss der Aufrufer keine EAP-Identitätsinformationen an RasDial-übergeben.
ERROR_RASMAN_CANNOT_INITIALIZE	Der Remotezugriffsdienst konnte nicht ordnungsgemäß initialisiert werden.
Andere	Verwenden Sie FormatMessage-, um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Bemerkungen

RasGetEapUserIdentity ruft die RAS-Funktion RasGetEapUserData und die EAP-Funktion RasEapGetIdentityauf. RasEapGetIdentity wird vom Authentifizierungsprotokoll implementiert.

Wenn die Funktion erfolgreich ist, ist dies der Rückgabewert NO_ERROR, sollte der Aufrufer die EAP-Identitätsinformationen aus der RASEAPUSERIDENTITY- Struktur kopieren, auf die durch den ppRasEapUserIdentity Parameter in den RASDIALPARAMS und RASDIALEXTENSIONS Strukturen verwiesen wird, die im Aufruf von RasDialverwendet werden.

Wenn die entwickelte Remotezugriffsanwendung über eine grafische Benutzeroberfläche verfügt, sollte der Aufrufer von RasGetEapUserIdentity das RASEAPF_NonInteractive Flag nicht angeben. Wenn die Anwendung über eine Befehlszeilenbenutzeroberfläche verfügt, kann der Aufrufer das RASEAPF_NonInteractive Flag angeben, um zu verhindern, dass das Authentifizierungsprotokoll eine grafische Benutzeroberfläche anzeigt.

Anmerkung

Der Ras.h-Header definiert RasGetEapUserIdentity als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ras.h
Library	Rasapi32.lib
DLL-	Rasapi32.dll