Share via

RasSetCustomAuthDataA-Funktion (ras.h)

  • Artikel

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

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

Zeiger auf einen Puffer, der die neuen Authentifizierungsdaten angibt.

[in] dwSizeofCustomAuthData

Gibt die Größe der Daten an, auf die der Parameter pbCustomAuthData 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 dwSizeofCustomAuthData-Parameter ist 0, 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.

Hinweise

Hinweis

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 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

RasGetCustomAuthData

RasSetEapUserData