RasGetAutodialParamA-Funktion (ras.h)

Artikel
08/25/2023

Die RasGetAutodialParam-Funktion ruft den Wert eines AutoDial-Parameters ab.

Syntax

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

Parameter

[in] unnamedParam1

Gibt den abzurufenden AutoDial-Parameter an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
RASADP_DisableConnectionQuery	Der lpvValue-Parameter gibt einen DWORD-Wert zurück. Wenn dieser Wert 0 (Standard) ist, zeigt AutoDial ein Dialogfeld an, in dem der Benutzer abgefragt werden kann, bevor eine Verbindung hergestellt wird. Wenn dieser Wert 1 ist und die AutoDial-Datenbank über den Telefonbucheintrag verfügt, um zu wählen, erstellt AutoDial eine Verbindung, ohne dass das Dialogfeld angezeigt wird.
RASADP_LoginSessionDisable	Der lpvValue-Parameter gibt einen DWORD-Wert zurück. Wenn dieser Wert 1 ist, deaktiviert das System alle AutoDial-Verbindungen für die aktuelle Anmeldesitzung. Wenn dieser Wert 0 (Standard) ist, werden AutoDial-Verbindungen aktiviert. Der AutoDial-Systemdienst ändert diesen Wert auf Null, wenn sich ein neuer Benutzer bei der Arbeitsstation anmeldet.
RASADP_SavedAddressesLimit	Der lpvValue-Parameter gibt einen DWORD-Wert zurück, der die maximale Anzahl von Adressen angibt, die AutoDial in der Registrierung speichert. AutoDial speichert zuerst Adressen, die zum Erstellen einer AutoDial-Verbindung verwendet wurden; dann speichert es Adressen, die nach dem Erstellen einer RAS-Verbindung gelernt wurden. Adressen, die mit der RasSetAutodialAddress-Funktion geschrieben wurden, werden immer gespeichert und nicht in die Berechnung des Grenzwerts einbezogen. Der Standardwert ist 100.
RASADP_FailedConnectionTimeout	Der lpvValue-Parameter gibt einen DWORD-Wert zurück, der einen Timeoutwert in Sekunden angibt. Wenn ein AutoDial-Verbindungsversuch fehlschlägt, deaktiviert der AutoDial-Systemdienst nachfolgende Versuche, dieselbe Adresse für den Timeoutzeitraum zu erreichen. Dadurch wird verhindert, dass AutoDial mehrere Verbindungsdialogfelder für dieselbe logische Anforderung durch eine Anwendung anzeigt. Der Standardwert ist 5.
RASADP_ConnectionQueryTimeout	Der lpvValue-Parameter verweist auf einen DWORD-Wert , der einen Timeoutwert in Sekunden angibt. Vor dem Versuch einer AutoDial-Verbindung zeigt das System ein Dialogfeld an, in dem der Benutzer aufgefordert wird, zu bestätigen, dass das System wählen soll. Das Dialogfeld verfügt über einen Countdown-Timer, der das Dialogfeld mit der Auswahl "Nicht wählen" beendet, wenn der Benutzer keine Aktion ausführt. Der DWORD-Wert , auf den von lpvValue verwiesen wird, gibt die anfängliche Zeit für diesen Countdowntimer an.

[out] unnamedParam2

Zeiger auf einen Puffer, der den Wert für den angegebenen Parameter empfängt.

[in, out] unnamedParam3

Zeiger auf einen DWORD-Wert .

Legen Sie bei der Eingabe diesen Wert fest, um die Größe des lpvValue-Puffers in Bytes anzugeben.

Bei der Ausgabe gibt dieser Wert die tatsächliche Größe des Werts an, der in den Puffer geschrieben 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	Bedeutung
ERROR_INVALID_PARAMETER	Der dwKey- oder lpvValue-Parameter ist ungültig.
ERROR_INVALID_SIZE	Die von lpdwcbValue angegebene Größe ist zu klein.

Hinweise

Hinweis

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

RasSetAutodialAddress

RasSetAutodialParam

Ras-Dienst (Ras) – Übersicht

Funktionen des RAS-Diensts

Share via