Phone-Book Dateien und Verbindungsinformationen

Ein RasDial-Aufruf muss die Informationen angeben, die der Remotezugriffs-Verbindungs-Manager zum Herstellen der Verbindung benötigt. In der Regel stellt der RasDial-Anruf die Verbindungsinformationen bereit, indem ein Telefonbucheintrag angegeben wird. Die Verbindungsinformationen in einem Telefonbucheintrag umfassen Telefonnummern, Bps-Raten, Benutzerauthentifizierungsinformationen und andere Verbindungsinformationen.

Ein RAS-Client verwendet die Parameter der RasDial-Funktion , um eine Telefonbuchdatei und einen Eintrag in dieser Datei anzugeben. Der parameter lpszPhonebookPath kann den Namen einer Telefonbuchdatei oder NULL angeben, um anzugeben, dass die Standard-Telefonbuchdatei verwendet werden soll. Der lpRasDialParams-Parameter verweist auf eine RASDIALPARAMS-Struktur , die den Namen des zu verwendenden Telefonbucheintrags angibt.

Um eine Liste von Telefonbucheinträgen anzuzeigen, aus denen der Benutzer eine Verbindung auswählen kann, kann ein RAS-Client die RasEnumEntries-Funktion aufrufen, um die Einträge in einer Telefonbuchdatei aufzulisten.

Um eine Verbindung herzustellen, ohne einen Telefonbucheintrag zu verwenden, kann der RasDial-Aufruf eine leere Zeichenfolge für das element szEntryName der RASDIALPARAMS-Struktur angeben. Das RASDIALPARAMS.szPhoneNumber-Mitglied muss die nummer enthalten, die aufgerufen werden soll. In diesem Fall verwendet die Remotezugriffs-Verbindungs-Manager den ersten verfügbaren Modemport und die Standardwerte für alle anderen Einstellungen.