RasSetEapUserDataA-Funktion (ras.h)

Artikel
03/01/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 Eines primären Zugriffstokens oder Identitätswechsels, das den Benutzer darstellt, für den Daten gespeichert werden sollen. Dieser Parameter kann NULL sein, wenn die Funktion von einem Prozess aufgerufen wird, der bereits im Kontext des Benutzers ausgeführt wird.

[in] pszPhonebook

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

[in] pszEntry

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

[in] pbEapData

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

[in] dwSizeofEapData

Gibt die Größe der Daten an, auf die der parameter pbEapData 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 RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
E_INVALIDARG	Der dwSizeofEapData-Parameter ist 0, oder der pbEapData-Parameter 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.

Hinweise

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll

Weitere Informationen

RasGetEapUserData

RasInvokeEapUI

Ras-Dienst (Ras) – Übersicht

Funktionen des RAS-Diensts

Share via