RasSetAutodialParamA-Funktion (ras.h)
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 einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Der lpvValue Parameter verweist auf einen DWORD--Wert. Wenn dieser Wert null (Standardeinstellung) ist, zeigt AutoDial ein Dialogfeld an, in dem der Benutzer abgefragt wird, bevor eine Verbindung erstellt wird. Wenn dieser Wert eins ist und die AutoDial-Datenbank über den Wähleintrag für das Telefonbuch verfügt, erstellt AutoDial eine Verbindung, ohne das Dialogfeld anzuzeigen. |
|
Der lpvValue Parameter verweist auf einen DWORD--Wert. Wenn dieser Wert eins ist, deaktiviert das System alle AutoDialverbindungen für die aktuelle Anmeldesitzung. Wenn dieser Wert null (standardeinstellung) ist, sind AutoDialverbindungen aktiviert. Der AutoDial-Systemdienst ändert diesen Wert auf Null, wenn sich ein neuer Benutzer bei der Arbeitsstation anmeldet. |
|
Der lpvValue--Parameter verweist auf einen DWORD- Wert, der die maximale Anzahl von Adressen angibt, die autoDial in der Registrierung gespeichert werden. AutoDial speichert zuerst Adressen, die zum Erstellen einer autoDialen Verbindung verwendet wurden; anschließend werden Adressen gespeichert, die nach dem Erstellen einer RAS-Verbindung gelernt wurden. Adressen, die mithilfe der RasSetAutodialAddress-Funktion geschrieben wurden, werden immer gespeichert und nicht in die Berechnung des Grenzwerts einbezogen. Der Standardwert ist 100. |
|
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 von einer Anwendung anzeigt. Der Standardwert ist fünf. |
|
Der lpvValue--Parameter verweist auf einen DWORD- Wert, der einen Timeoutwert in Sekunden angibt. Vor dem Versuch einer autoDialen Verbindung zeigt das System ein Dialogfeld an, in dem der Benutzer aufgefordert wird, zu bestätigen, dass das System gewählt werden soll. Das Dialogfeld verfügt über einen Countdown-Timer, der das Dialogfeld mit einer Auswahl "Nicht wählen" beendet, wenn der Benutzer keine Aktion ausführt. Der DWORD--Wert, auf den lpvValue verweist, gibt die anfängliche Zeit für diesen Countdown-Timer an. |
[out] unnamedParam2
Zeigen Sie 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 Remotezugriffsfehlercodes oder Winerror.h.
| Wert | Bedeutung |
|---|---|
|
Der parameter dwKey oder lpvValue ist ungültig. |
|
Die durch die dwcbValue- angegebene Größe ist ungültig. |
Bemerkungen
Anmerkung
Der ras.h-Header definiert RasSetAutodialParam 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 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 |
Siehe auch
übersicht über Ras(Remote Access Service)