Share via

RasSetAutodialParamA-Funktion (ras.h)

  • Artikel

Die RasSetAutodialParam-Funktion legt den Wert eines AutoDial-Parameters fest.

Syntax

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

Parameter

[in] unnamedParam1

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

Wert Bedeutung
RASADP_DisableConnectionQuery
 Der lpvValue-Parameter zeigt auf einen DWORD-Wert . 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 eins ist und die AutoDial-Datenbank über den zu wählenden Telefonbucheintrag verfügt, erstellt AutoDial eine Verbindung, ohne das Dialogfeld anzuzeigen.
RASADP_LoginSessionDisable
 Der lpvValue-Parameter zeigt auf einen DWORD-Wert . Wenn dieser Wert eins 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 in Null, wenn sich ein neuer Benutzer bei der Arbeitsstation anmeldet.
RASADP_SavedAddressesLimit
 Der Parameter lpvValue verweist auf einen DWORD-Wert , 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 er nach dem Erstellen einer RAS-Verbindung gelernt hat. 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 verweist auf einen DWORD-Wert , 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 fünf.
RASADP_ConnectionQueryTimeout
 Der lpvValue-Parameter verweist auf einen DWORD-Wert , der einen Timeoutwert in Sekunden angibt. Vor dem Versuch, eine AutoDial-Verbindung herzustellen, 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 den Dialog mit der Auswahl "Nicht wählen" beendet, wenn der Benutzer keine Aktion ausführt. Der DWORD-Wert , auf den lpvValue verweist, gibt die Anfangszeit dieses Countdowntimers an.

[out] unnamedParam2

Zeiger auf einen Puffer, der den neuen Wert für den angegebenen Parameter enthält.

[in] unnamedParam3

Gibt die Größe des Werts im lpvValue-Puffer in Bytes an.

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 dwcbValue angegebene Größe ist ungültig.

Hinweise

Hinweis

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

Weitere Informationen

RasGetAutodialParam

RasSetAutodialAddress

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts