Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der pdwSizeofCustomAuthData-Parameter ist NULL. |
|
Der Puffer, auf den pbCustomAuthData verweist, ist zu klein, um die Daten zu empfangen. PdwSizeofCustomAuthData enthält die erforderliche Größe. |
|
RasGetEapUserData konnte die angegebene Telefonbuchdatei nicht öffnen. |
|
RasGetEapUserData konnte den angegebenen Eintrag im Telefonbuch nicht finden. |
|
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 |