RasGetAutodialParamA-Funktion (ras.h)
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 einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Der lpvValue--Parameter gibt einen DWORD- Wert zurück. 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 1 ist und die AutoDial-Datenbank über den Telefonbucheintrag für die Wählverbindung verfügt, erstellt AutoDial eine Verbindung, ohne das Dialogfeld anzuzeigen. |
|
Der lpvValue--Parameter gibt einen DWORD- Wert zurück. Wenn dieser Wert 1 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 gibt einen DWORD--Wert zurück, 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 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 von einer Anwendung anzeigt. Der Standardwert ist 5. |
|
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 erste Zeit für diesen Countdown-Timer an. |
[out] unnamedParam2
Zeigen Sie auf einen Puffer, der den Wert für den angegebenen Parameter empfängt.
[in, out] unnamedParam3
Zeigen Sie 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 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 | Bedeutung |
|---|---|
|
Der parameter dwKey oder lpvValue ist ungültig. |
|
Die durch die lpdwcbValue angegebene Größe ist zu klein. |
Bemerkungen
Anmerkung
Der ras.h-Header definiert RasGetAutodialParam 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)