RasGetEapUserDataA-Funktion (ras.h)

Artikel
03/01/2024

Verwenden Sie die RasGetEapUserData-Funktion , um benutzerspezifische EAP-Informationen (Extensible Authentication Protocol) für den angegebenen Telefonbucheintrag abzurufen.

Syntax

DWORD RasGetEapUserDataA(
  [in]      HANDLE hToken,
  [in]      LPCSTR pszPhonebook,
  [in]      LPCSTR pszEntry,
  [out]     BYTE   *pbEapData,
  [in, out] DWORD  *pdwSizeofEapData
);

Parameter

[in] hToken

Behandeln Sie ein primäres Zugriffstoken oder identitätswechsel, das den Benutzer darstellt, für den Daten abgerufen 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.

[out] pbEapData

Zeiger auf einen Puffer, der die abgerufenen EAP-Daten für den Benutzer empfängt. Der Aufrufer sollte den Arbeitsspeicher für diesen Puffer zuordnen. Wenn der Puffer nicht groß genug ist, gibt RasGetEapUserDataERROR_BUFFER_TOO_SMALL zurück, und der Parameter pdwSizeofEapData enthält die erforderliche Größe.

[in, out] pdwSizeofEapData

Zeiger auf eine DWORD-Variable , die bei der Eingabe die Größe des Puffers angibt, auf den der pbEapData-Parameter verweist.

Wenn der vom pbEapData-Parameter angegebene Puffer nicht groß genug ist, erhält pdwSizeofEapData bei der Ausgabe die erforderliche Größe.

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 pdwSizeofEapData-Parameter ist NULL.
ERROR_BUFFER_TOO_SMALL	Der Puffer, auf den pbEapData verweist, ist zu klein, um die Daten zu empfangen. PdwSizeofEapData enthält die erforderliche Größe.
ERROR_CANNOT_OPEN_PHONEBOOK	RasGetEapUserData konnte die angegebene Telefonbuchdatei nicht öffnen.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasGetEapUserData 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 RasGetEapUserData als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

RASEAPINFO

RasSetEapUserData

Ras-Dienst (Ras) – Übersicht

Funktionen des RAS-Diensts

Share via