Subenti dan Koneksi Multilink

Windows NT Server 4.0 menyediakan dukungan untuk subentri buku telepon, yang memungkinkan koneksi multilink. Koneksi multilink menggabungkan bandwidth beberapa koneksi untuk menyediakan satu koneksi dengan bandwidth yang lebih tinggi.

Entri buku telepon RAS dapat memiliki nol atau lebih subentri. Fungsi RasGetEntryProperties mengambil struktur RASENTRY yang mencakup informasi tentang subentri entri buku telepon. Anggota dwSubEntries dari struktur RASENTRY menunjukkan jumlah subentri. entri Telepon-buku awalnya tidak memiliki subentri. Untuk menambahkan subentri ke entri buku telepon, gunakan fungsi RasSetSubEntryProperties .

Properti untuk setiap subentri mencakup nomor telepon dan nama dan jenis perangkat TAPI yang akan digunakan saat memutar subentri. Selain itu, subentri dapat menyertakan daftar nomor telepon alternatif untuk dial jika RAS tidak dapat membuat koneksi menggunakan nomor utama. Fungsi RasSetSubEntryProperties dan RasGetSubEntryProperties menggunakan struktur RASSUBENTRY untuk mengatur dan mengambil properti subentri buku telepon tertentu. Subenti diidentifikasi oleh indeks berbasis satu.

Anda dapat memanggil fungsi RasSetEntryProperties untuk mengonfigurasi entri RAS multilink untuk menyambungkan semua subentri saat pertama kali dipanggil. Atau, Anda dapat mengonfigurasi entri untuk menyediakan bandwidth variabel. Dalam hal ini, RAS menyambungkan satu subentri pada awalnya, lalu menyambungkan atau memutuskan subentri tambahan sesuai kebutuhan. Untuk koneksi multilink bandwidth variabel, Anda dapat menggunakan struktur RASDIALPARAMS untuk menentukan subentri awal yang akan disambungkan saat Anda memanggil fungsi RasDial . Saat menggunakan fungsi RasDialDlg untuk menyambungkan entri multilink, Anda dapat menggunakan struktur RASDIALDLG untuk menentukan subentri awal yang akan disambungkan.

Untuk koneksi multilink bandwidth variabel, gunakan struktur RASENTRY dengan fungsi RasSetEntryProperties untuk menentukan parameter untuk menyambungkan dan memutuskan subentri individual. RAS menyambungkan subentri tambahan saat bandwidth yang digunakan melebihi persentase tertentu dari bandwidth yang tersedia untuk interval tertentu.

Jika Anda memanggil fungsi RasDial untuk membuat koneksi multilink, Anda dapat menentukan fungsi panggilan balik RasDialFunc2 untuk menerima pemberitahuan tentang koneksi. RasDialFunc2 mirip dengan fungsi panggilan balik RasDialFunc1 , kecuali bahwa ia menyediakan informasi tambahan untuk koneksi multilink, seperti indeks subentri yang menyebabkan pemberitahuan. RAS memanggil fungsi RasDialFunc2 Anda saat menyambungkan atau memutuskan subentry.

Anda dapat menggunakan handel koneksi HRASCONN untuk menutup atau mengambil informasi tentang koneksi multilink. Anda bisa mendapatkan handel koneksi untuk setiap koneksi subentri yang membentuk multilink, serta untuk koneksi multilink gabungan. Saat Anda memanggil fungsi RasDial untuk membuat koneksi multilink, RasDial mengembalikan handel ke koneksi multilink gabungan. Demikian pula, RasEnumConnections mengembalikan gagang multilink gabungan saat Anda menghitung koneksi. Untuk mendapatkan handel ke salah satu koneksi subentri dalam koneksi multilink, panggil fungsi RasGetSubEntryHandle .

Anda dapat menggunakan gagang koneksi multilink gabungan dan handel koneksi subentri di fungsi RasHangUp, RasGetConnectStatus, dan RasGetProjectionInfo . Memanggil RasHangUp dengan handel multilink gabungan mengakhiri seluruh koneksi; memanggilnya dengan handel subentry hanya menutup koneksi subentri tersebut. Demikian pula, RasGetConnectStatus mengembalikan informasi untuk koneksi gabungan atau individual, tergantung pada handel yang ditentukan. Informasi proyeksi yang dikembalikan oleh RasGetProjectionInfo untuk entri multilink sama untuk setiap handel koneksi subentry seperti untuk handel koneksi utama.