RasGetEntryDialParamsA-Funktion (ras.h)

Artikel
08/25/2023

Die RasGetEntryDialParams-Funktion ruft die Verbindungsinformationen ab, die beim letzten erfolgreichen Aufruf der 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

Zeiger auf eine NULL-beendete Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL ist, verwendet die Funktion die aktuelle Standard-Telefonbuchdatei. Die Standard-Telefonbuchdatei wird vom Benutzer im Eigenschaftenblatt Benutzereinstellungen des DialogfeldsDFÜ-Netzwerk ausgewählt.

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

[in, out] unnamedParam2

Zeiger auf eine RASDIALPARAMS-Struktur .

Bei der Eingabe gibt das dwSize-Element die Größe der RASDIALPARAMS-Struktur an, und das szEntryName-Element gibt einen gültigen Telefonbucheintrag an.

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

Beachten Sie, dass das szPhoneNumber-Element der Struktur die dem Telefonbucheintrag zugeordnete Telefonnummer nicht empfängt. Um die Telefonnummer abzurufen, die einem Telefonbucheintrag zugeordnet ist, rufen Sie die RasGetEntryProperties-Funktion auf . Wenn szPhoneNumber eine leere Zeichenfolge in der RASDIALPARAMS-Struktur ist, die an RasDial übergeben wird, verwendet RasDial die im Telefonbucheintrag gespeicherte Telefonnummer.

Das szPassword-Element 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 durch 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: Die Funktion "Sicheres Kennwort" wird nicht unterstützt.

[out] unnamedParam3

Zeiger 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 lpfPasswordFALSE.

Windows NT und Windows Me/98/95: Die Funktion legt dieses Flag auf TRUE fest, wenn das Kennwort des Benutzers im szPassword-Member der RASDIALPARAMS-Struktur zurückgegeben wurde, auf die von lprasdialparams 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 RAS-Fehlercodes oder Winerror.h.

Wert	BESCHREIBUNG
ERROR_BUFFER_INVALID	Der Zeiger lprasdialparams oder lpfPassword ist ungültig, oder der Puffer lprasdialparams ist ungültig.
ERROR_CANNOT_OPEN_PHONEBOOK	Das Telefonbuch ist beschädigt oder es fehlen Komponenten.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Der Telefonbucheintrag ist nicht vorhanden.

Hinweise

Hinweis

Der ras.h-Header definiert RasGetEntryDialParams als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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


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