RasGetCustomAuthDataA-Funktion (ras.h)

Artikel
03/01/2024

Verwenden Sie die RasGetCustomAuthData-Funktion , um verbindungsspezifische Authentifizierungsinformationen abzurufen. Diese Informationen sind nicht spezifisch für einen bestimmten Benutzer.

Syntax

DWORD RasGetCustomAuthDataA(
  [in]      LPCSTR pszPhonebook,
  [in]      LPCSTR pszEntry,
  [out]     BYTE   *pbCustomAuthData,
  [in, out] DWORD  *pdwSizeofCustomAuthData
);

Parameter

[in] pszPhonebook

Zeiger auf eine NULL-endende 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-endende Zeichenfolge, die einen vorhandenen Eintragsnamen angibt.

[out] pbCustomAuthData

Zeiger auf einen Puffer, der die Authentifizierungsdaten empfängt. Der Aufrufer sollte den Speicher für diesen Puffer zuordnen. Wenn der Puffer nicht groß genug ist, gibt RasGetCustomAuthData ERROR_BUFFER_TOO_SMALL zurück, und der Parameter pdwSizeofEapData enthält die erforderliche Größe.

[in, out] pdwSizeofCustomAuthData

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

Wenn der durch den pbCustomAuthData-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 pdwSizeofCustomAuthData-Parameter ist NULL.
ERROR_BUFFER_TOO_SMALL	Der Puffer, auf den pbCustomAuthData verweist, ist zu klein, um die Daten zu empfangen. PdwSizeofCustomAuthData 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 RasGetCustomAuthData 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
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

RasSetCustomAuthData

Freigeben über