RasGetEntryDialParamsA-Funktion (ras.h)

Artikel
11/20/2024

Die RasGetEntryDialParams Funktion ruft die Verbindungsinformationen ab, die vom letzten erfolgreichen Aufruf des RasDial oder RasSetEntryDialParams Funktion für einen angegebenen Telefonbucheintrag gespeichert wurden.

Syntax

DWORD RasGetEntryDialParamsA(
  [in]      LPCSTR           unnamedParam1,
  [in, out] LPRASDIALPARAMSA unnamedParam2,
  [out]     LPBOOL           unnamedParam3
);

Parameter

[in] unnamedParam1

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den vollständigen Pfad und Dateinamen einer PbK-Datei (Phone-Book) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion die aktuelle Standarddatei des Telefonbuchs. Die Standardmäßige Telefonbuchdatei ist die vom Benutzer im Eigenschaftenblatt Benutzereinstellungen Eigenschaftenblatt des Dialogfelds DFÜ-Netzwerk ausgewählt.

Windows Me/98/95: Dieser Parameter sollte immer NULL-sein. DFÜ-Netzwerke speichern Telefonbucheinträge in der Registrierung und nicht in einer Telefonbuchdatei.

[in, out] unnamedParam2

Zeiger auf eine RASDIALPARAMS- Struktur.

Bei Eingaben gibt das dwSize Member die Größe der RASDIALPARAMS--Struktur an, und das szEntryName Member gibt einen gültigen Eintrag für Telefonbuch an.

Bei der Ausgabe empfängt die Struktur die Verbindungsparameter, die dem angegebenen Telefonbucheintrag zugeordnet sind.

Beachten Sie, dass das szPhoneNumber- Mitglied der Struktur nicht die Telefonnummer erhält, die dem Eintrag "Telefonbuch" zugeordnet ist. Rufen Sie die RasGetEntryProperties-Funktion auf, um die Telefonnummer abzurufen, die einem Telefonbucheintrag zugeordnet ist. Wenn szPhoneNumber eine leere Zeichenfolge in der RASDIALPARAMS Struktur ist, die an RasDialübergeben wird, verwendet RasDial die im Eintrag des Telefonbuchs gespeicherte Telefonnummer.

Das szPassword- Mitglied der RASDIALPARAMS- Struktur gibt das tatsächliche Kennwort nicht zurück. Stattdessen enthält szPassword- ein Handle für das gespeicherte Kennwort. Ersetzen Sie dieses Handle für das gespeicherte Kennwort in nachfolgenden Aufrufen von RasSetEntryDialParams und RasDial-. Wenn dieses Handle angezeigt wird, ruft RasDial das gespeicherte Kennwort ab und verwendet es. Der Wert dieses Handles kann sich in zukünftigen Versionen des Betriebssystems ändern; Entwickeln Sie keinen Code, der vom Inhalt oder Format dieses Werts abhängt.

Windows NT und Windows Me/98/95: Feature "Sicheres Kennwort" wird nicht unterstützt.

[out] unnamedParam3

Zeigen Sie auf ein Flag, das angibt, ob die Funktion das Kennwort abgerufen hat, das dem Benutzernamen für den Telefonbucheintrag zugeordnet ist. Der lpfPassword Parameter ist TRUE, wenn das System ein Kennwort für den angegebenen Eintrag gespeichert hat. Wenn das System kein Kennwort für diesen Eintrag gespeichert hat, ist lpfPassword-FALSE.

Windows NT und Windows Me/98/95: Die Funktion legt dieses Kennzeichen auf TRUE fest, wenn das Kennwort des Benutzers im szPassword Member der RASDIALPARAMS Struktur zurückgegeben wurde, auf die von lprasdialparamsverwiesen wurde.

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	Beschreibung
ERROR_BUFFER_INVALID	Der lprasdialparams oder lpfPassword Zeiger ist ungültig, oder der lprasdialparams Puffer ist ungültig.
ERROR_CANNOT_OPEN_PHONEBOOK	Das Telefonbuch ist beschädigt oder fehlende Komponenten.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Der Telefonbucheintrag ist nicht vorhanden.

Bemerkungen

Anmerkung

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