Untereinträge und Multilinkverbindungen
Windows NT Server 4.0 bietet Unterstützung für Telefonbuchuntereinträge, die Multilinkverbindungen ermöglichen. Eine Multilinkverbindung kombiniert die Bandbreite mehrerer Verbindungen, um eine einzelne Verbindung mit höherer Bandbreite bereitzustellen.
Ein RAS-Telefonbucheintrag kann 0 (null) oder mehr Untereinträge aufweisen. Die RasGetEntryProperties-Funktion ruft eine RASENTRY-Struktur ab, die Informationen zu den Untereinträgen eines Telefonbucheintrags enthält. Der dwSubEntries-Member der RASENTRY-Struktur gibt die Anzahl der Untereinträge an. Telefon Bucheinträge haben anfänglich keine Untereinträge. Verwenden Sie die RasSetSubEntryProperties-Funktion, um einem Telefonbucheintrag Untereinträge hinzuzufügen.
Die Eigenschaften für die einzelnen Unterversuche umfassen eine Telefonnummer und den Namen und Typ des TAPI-Geräts, das beim Wählen des unteren Wiederholungsversuchs verwendet werden soll. Darüber hinaus kann ein Unterversuch eine Liste alternativer Telefonnummern enthalten, die gewählt werden können, wenn RAS keine Verbindung mit der primären Nummer herstellen kann. Die Funktionen RasSetSubEntryProperties und RasGetSubEntryProperties verwenden die RASSUBENTRY-Struktur, um die Eigenschaften eines angegebenen Telefonbuchunterversuchs festzulegen und abzurufen. Untereinträge werden durch einen einsbasierten Index identifiziert.
Sie können die RasSetEntryProperties-Funktion aufrufen, um einen Multilink-RAS-Eintrag zum Verbinden aller Untereinträge zu konfigurieren, wenn er zum ersten Mal gewählt wird. Alternativ können Sie einen Eintrag konfigurieren, um variable Bandbreite bereitzustellen. In diesem Fall stellt RAS zunächst eine Verbindung mit einem einzelnen unteren Versuch her und stellt dann bei Bedarf eine Verbindung mit zusätzlichen Untereinträgen her oder trennt diese. Für eine Multilinkverbindung mit variabler Bandbreite können Sie die RASDIALPARAMS-Struktur verwenden, um den anfänglichen Unterversuch für die Verbindung anzugeben, wenn Sie die RasDial-Funktion aufrufen. Wenn Sie die RasDialDlg-Funktion verwenden, um eine Verbindung mit einem Multilinkeintrag herzustellen, können Sie die RASDIALDLG-Struktur verwenden, um den anfänglichen Unterversuch für die Verbindung anzugeben.
Verwenden Sie für eine Multilinkverbindung mit variabler Bandbreite die RASENTRY-Struktur mit der RasSetEntryProperties-Funktion, um die Parameter für das Verbinden und Trennen der einzelnen Untereinträge anzugeben. RAS verbindet einen zusätzlichen Unterversuch, wenn die verwendete Bandbreite einen angegebenen Prozentsatz der verfügbaren Bandbreite für ein angegebenes Intervall überschreitet.
Wenn Sie die RasDial-Funktion aufrufen, um eine Multilinkverbindung herzustellen, können Sie eine RasDialFunc2-Rückruffunktion angeben, um Benachrichtigungen über die Verbindung zu empfangen. RasDialFunc2 ähnelt der RasDialFunc1-Rückruffunktion, stellt jedoch zusätzliche Informationen für eine Multilinkverbindung bereit, z. B. den Index der Unterversuche, die die Benachrichtigung verursacht haben. RAS ruft Ihre RasDialFunc2-Funktion auf, wenn sie eine Verbindung mit einem unteren Versuch herstellt oder die Verbindung trennt.
Sie können ein HRUNENN-Verbindungshandle zum Aufhängen oder Abrufen von Informationen zu einer Multilinkverbindung verwenden. Sie können ein Verbindungshandle für jede der Unterversuchsverbindungen abrufen, aus denen der Multilink besteht, sowie für die kombinierte Multilinkverbindung. Wenn Sie die RasDial-Funktion aufrufen, um eine Multilinkverbindung herzustellen, gibt RasDial ein Handle für die kombinierte Multilinkverbindung zurück. Auf ähnliche Weise gibt RasEnumConnections das kombinierte Multilinkhandle zurück, wenn Sie Verbindungen aufzählen. Rufen Sie die RasGetSubEntryHandle-Funktion auf, um ein Handle für eine der Unterentryverbindungen in einer Multilinkverbindung abzurufen.
Sie können das kombinierte Multilinkverbindungshandle und die Untergeordneten Verbindungshandles in den Funktionen RasHangUp, RasGetConnectStatusund RasGetProjectionInfo verwenden. Wenn Sie RasHangUp mit einem kombinierten Multilinkhandle aufrufen, wird die gesamte Verbindung beendet. Wenn sie mit einem untergeordneten Wiederholungshandle aufgerufen wird, wird nur diese Unterversuchsverbindung aufhängen. Auf ähnliche Weise gibt RasGetConnectStatus Abhängig vom angegebenen Handle Informationen für die kombinierte oder einzelne Verbindung zurück. Die projektionsinformationen, die von RasGetProjectionInfo für einen Multilinkeintrag zurückgegeben werden, sind für jeden der Verbindungshandles für untergeordneten Versuch identisch wie für das Hauptverbindungshandle.