Skrip Kustom RAS

Pengembang dapat membuat DLL skrip kustom yang berada di komputer klien RAS. DLL ini dapat berkomunikasi dengan server selama proses pembuatan koneksi.

Windows NT: Pembuatan skrip kustom tidak tersedia.

Menyiapkan DLL

Untuk menyiapkan DLL, buat nilai dengan nama CustomScriptDllPath di bawah kunci registri berikut:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            Rasman
               Parameters

Nilai ini harus berjenis REG_EXPAND_SZ. Nilai harus berisi jalur ke DLL skrip kustom. Hanya satu DLL skrip kustom yang didukung untuk setiap komputer klien RAS.

Interaksi Antara Server, RAS, dan DLL Custom-Scripting

DLL skrip kustom harus mengekspor satu titik masuk: RasCustomScriptExecute. RAS memanggil fungsi ini selama status RASCS_Interactive proses koneksi. Status RASCS_Interactive adalah status dijeda, yang memungkinkan pengguna berinteraksi dengan antarmuka pengguna yang disajikan oleh DLL skrip kustom. Lihat RASCONNSTATE untuk informasi selengkapnya tentang status koneksi.

RAS akan meneruskan sebagai parameter ke fungsi RasCustomScriptExecute :

• Handel ke porta pada komputer klien yang sedang digunakan untuk koneksi.
• String yang mengidentifikasi buku telepon dan entri untuk koneksi.
• RAS juga meneruskan handel ke jendela untuk mengaktifkan DLL untuk menyajikan antarmuka pengguna.
• Sekumpulan penunjuk fungsi yang dapat digunakan DLL untuk berkomunikasi dengan server.

Lihat RasCustomScriptExecute untuk informasi selengkapnya tentang parameter ini.

RAS meneruskan pointer ke struktur RASCUSTOMSCRIPTEXTENSIONS sebagai parameter terakhir untuk RasCustomScriptExecute. Struktur ini berisi penunjuk ke fungsi jenis PFNRASSETCOMMSETTINGS. DLL skrip kustom memanggil fungsi ini untuk mengubah pengaturan komunikasi pada port yang digunakan oleh koneksi.

RAS memmediasi interaksi antara server dan DLL skrip kustom. Biasanya, server memulai dialog. Misalnya, server dapat meminta nama pengguna dan kata sandi pengguna.

Saat menggunakan skrip kustom untuk membuat koneksi, server tidak perlu menjalankan Windows NT 4.0 atau Windows 2000.

Antarmuka Pengguna Pembuatan Skrip Kustom harus mendukung IDCANCEL

Jika dialer kustom menampilkan antarmuka pengguna, antarmuka pengguna harus mendukung pesan WM_COMMAND di mana LOWORD(wParam) sama dengan IDCANCEL.

Mengonfigurasi Koneksi

Titik entri RasCustomScriptExecute dapat dipanggil dari RasDialDlg atau, pada Windows XP, dari RasDial.

Untuk memanggil RasCustomScriptExecute dari RasDialDlg, atur opsi RASEO_CustomScript di entri buku telepon untuk koneksi. Lihat anggota dwfOptionsdari RASENTRY untuk deskripsi opsi entri buku telepon. Gunakan fungsi RasGetEntryProperties dan RasSetEntryProperties untuk mengatur opsi ini secara terprogram.

Windows XP: Untuk memanggil RasCustomScriptExecute dari RasDial, panggilan ke RasDial harus menentukan struktur RASDIALEXTENSIONS , dan struktur ini harus menentukan bendera RDEOPT_UseCustomScripting. Selain itu, entri buku telepon untuk koneksi harus menentukan opsi RASEO_CustomScript seperti yang dijelaskan dalam paragraf sebelumnya.

Memanggil DLL Pembuatan Skrip Kustom

Jika pengguna mengaktifkan koneksi untuk entri buku telepon yang memiliki RASEO_CustomScript diatur, RAS memanggil DLL pembuatan skrip kustom. Dalam skenario ini, RAS memanggil DLL skrip kustom dari RasDialDlg.

Untuk memanggil DLL skrip kustom secara terprogram, buat koneksi menggunakan fungsi RasDialDlg . Pada Windows XP, fungsi RasDial juga memanggil DLL skrip kustom.