AutoDial Connection Operations

Wenn beim Versuch, eine Verbindung mit einer Netzwerkadresse herzustellen, ein Fehler auftritt, weil der Host nicht erreicht werden kann, durchsucht das System die AutoDial-Zuordnungsdatenbank nach der Adresse. Wenn sich die Adresse in der Datenbank befindet, initiiert das System einen autodialen Vorgang für RASAUTODIALENTRY, sofern vorhanden, der dem lokalen TAPI-Wählpfad entspricht.

Die RAS-API stellt Funktionen bereit, mit denen Sie AutoDial-Parameter zum Steuern von AutoDial-Verbindungen festlegen und abfragen können. Sie können die RasSetAutodialEnable-Funktion aufrufen, um die AutoDial-Funktion für einen angegebenen TAPI-Wählort zu aktivieren oder zu deaktivieren. Die RasGetAutodialEnable-Funktion gibt an, ob die AutoDial-Funktion für einen angegebenen TAPI-Wählort aktiviert ist. Weitere Informationen zu TAPI-Wählorten finden Sie in der TAPI-Dokumentation. Sie können die RasSetAutodialParam-Funktion aufrufen, um andere AutoDial-Verbindungsparameter festzulegen. Beispielsweise können Sie AutoDial-Verbindungen für die aktuelle Anmeldesitzung deaktivieren. Rufen Sie die RasGetAutodialParam-Funktion auf, um den aktuellen Wert der AutoDial-Verbindungsparameter zu bestimmen.

Das System stellt eine Standardbenutzeroberfläche für AutoDial Dialing-Vorgänge bereit. Sie können jedoch eine AutoDial-DLL (Dynamic Link Library) erstellen, um eine benutzerdefinierte Benutzeroberfläche für AutoDial Dialing-Vorgänge mit angegebenen Telefonbucheinträgen bereitzustellen. Ihre autodiale DLL muss sowohl eine ANSI- als auch eine Unicode-Version eines RASADFunc AutoDial-Handlers exportieren.

Um Ihren benutzerdefinierten AutoDial-Handler für einen Telefonbucheintrag zu aktivieren, rufen Sie die RasSetEntryProperties-Funktion auf, um die Eigenschaften für diesen Eintrag festzulegen. Die an RasSetEntryProperties übergebenen szAutodialDll- und szAutodialFunc-Member der RASENTRY-Struktur geben den Namen Ihrer AutoDial-DLL und den Namen Ihrer RASADFunc-Funktion an, mit Ausnahme des Suffixes "A" oder "W".

Wenn das System einen AutoDial-Vorgang für einen Telefonbucheintrag mit einem benutzerdefinierten AutoDial-Handler startet, ruft es den angegebenen RASADFunc auf. Die RASADFunc-Funktion empfängt einen Zeiger auf eine RASADPARAMS-Struktur, die den Speicherort und das übergeordnete Fenster für das Fenster Ihrer Benutzeroberfläche angibt. RasadFunc kann einen Thread starten, um den benutzerdefinierten Wählvorgang auszuführen. Die RASADFunc-Funktion gibt TRUE zurück, um anzugeben, dass sie die Wählfunktion übernommen hat, oder FALSE, um dem System das Wählen zu ermöglichen. Ihr benutzerdefinierter Wählvorgang muss die RasDial-Funktion verwenden, um die tatsächliche Wählfunktion durchzuführen. Wenn der Wählvorgang abgeschlossen wurde, gibt der benutzerdefinierte Wählvorgang einen Erfolg oder Fehler an, indem die Variable festgelegt wird, auf die der lpdwRetCode-Parameter verweist, der an RASADFuncübergeben wird.