RasSetEapUserDataA-Funktion (ras.h)

Artikel
11/20/2024

Verwenden Sie die RasSetEapUserData--Funktion, um benutzerspezifische EAP-Informationen (Extensible Authentication Protocol) für den angegebenen Telefonbucheintrag in der Registrierung zu speichern.

Syntax

DWORD RasSetEapUserDataA(
  [in] HANDLE hToken,
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbEapData,
  [in] DWORD  dwSizeofEapData
);

Parameter

[in] hToken

Behandeln Sie ein primäres Zugriffstoken oder Identitätswechseltoken, das den Benutzer darstellt, für den Daten gespeichert werden sollen. Dieser Parameter kann NULL- werden, wenn die Funktion von einem Prozess aufgerufen wird, der bereits im Kontext des Benutzers ausgeführt wird.

[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] pbEapData

Zeigen Sie auf die Daten, die für den Benutzer gespeichert werden sollen.

[in] dwSizeofEapData

Gibt die Größe der Daten an, auf die der pbEapData-Parameter verweist.

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_INVALIDARG	Der parameter dwSizeofEapData ist null, oder der parameter pbEapData ist NULL.
ERROR_CANNOT_OPEN_PHONEBOOK	RasSetEapUserData- konnte die angegebene Telefonbuchdatei nicht öffnen.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasSetEapUserData konnte den angegebenen Eintrag im Telefonbuch nicht finden.
Andere	Verwenden Sie FormatMessage-, um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Bemerkungen

Anmerkung

Der Ras.h-Header definiert RasSetEapUserData 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

Siehe auch

RasGetEapUserData-

RasInvokeEapUI-

übersicht über Ras(Remote Access Service)

Remotezugriffsdienstfunktionen

Freigeben über