RasSetCustomAuthDataA-Funktion (ras.h)

Artikel
11/20/2024

Verwenden Sie die RasSetCustomAuthData--Funktion, um verbindungsspezifische Authentifizierungsinformationen festzulegen. Diese Informationen sollten nicht für einen bestimmten Benutzer spezifisch sein.

Syntax

DWORD RasSetCustomAuthDataA(
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbCustomAuthData,
  [in] DWORD  dwSizeofCustomAuthData
);

Parameter

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

Zeigen Sie auf einen Puffer, der die neuen Authentifizierungsdaten angibt.

[in] dwSizeofCustomAuthData

Gibt die Größe der Daten an, auf die durch den parameter pbCustomAuthData verwiesen wird.

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 dwSizeofCustomAuthData ist null, oder der parameter pbCustomAuthData 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 RasSetCustomAuthData 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

RasGetCustomAuthData-

RasSetEapUserData-

Freigeben über