RasGetEapUserDataA-Funktion (ras.h)

Artikel
11/20/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ätswechseltoken, das den Benutzer darstellt, für den Daten abgerufen 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 mit Null beendete Zeichenfolge, die den vollständigen Pfad der PbK-Datei (Phone-Book) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion das Systemtelefonbuch.

[in] pszEntry

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die einen vorhandenen Eintragsnamen angibt.

[out] pbEapData

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

[in, out] pdwSizeofEapData

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

Wenn der durch den parameter pbEapData angegebene Puffer nicht groß genug ist, pdwSizeofEapData bei der Ausgabe die erforderliche Größe empfängt.

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 pdwSizeofEapData ist NULL.
ERROR_BUFFER_TOO_SMALL	Der Puffer, auf den pbEapData- verweist, ist zu klein, um die Daten zu empfangen. Die 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.

Bemerkungen

Anmerkung

Der ras.h-Header definiert RasGetEapUserData 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

RASEAPINFO-

RasSetEapUserData-

übersicht über Ras(Remote Access Service)

Remotezugriffsdienstfunktionen

Freigeben über