fungsi TSPI_lineConfigDialog (tspi.h)

Artikel
03/08/2023

Fungsi TSPI_lineConfigDialog sudah usang. TAPI versi 1.4 atau penyedia layanan yang lebih lama dapat menerapkan fungsi TSPI ini. TSP TAPI versi 2.0 atau yang lebih baru menerapkan TUISPI_lineConfigDialog.

Fungsi TSPI_lineConfigDialog menyebabkan penyedia perangkat baris yang ditentukan menampilkan kotak dialog modal sebagai jendela anak hwndOwner untuk memungkinkan pengguna mengonfigurasi parameter yang terkait dengan perangkat baris.

Sintaks

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parameter

dwDeviceID

Perangkat baris yang akan dikonfigurasi.

hwndOwner

Handel ke jendela induk tempat jendela kotak dialog akan ditempatkan.

lpszDeviceClass

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi nama kelas perangkat. Kelas perangkat ini memungkinkan penelepon untuk memilih sub-layar tertentu dari informasi konfigurasi yang berlaku untuk kelas perangkat tersebut. Jika parameter ini NULL atau string kosong, kotak dialog konfigurasi tingkat tertinggi harus dipilih. String yang diizinkan sama dengan untuk TSPI_lineGetID. Misalnya, jika baris mendukung Comm API, meneruskan comm/datamodem sebagai lpszDeviceClass menyebabkan penyedia menampilkan parameter yang terkait khusus dengan Comm (atau, setidaknya, untuk memulai pada titik yang sesuai dalam rantai kotak dialog konfigurasi multitingkat, sehingga pengguna tidak perlu mencari untuk menemukan parameter yang diinginkan.)

Nilai kembali

Mengembalikan nol jika fungsi berhasil atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Prosedur harus memperbarui bagian [Windows Telephony] dalam file Win.ini dan menyiarkan pesan WM_WININICHANGE jika membuat perubahan pada file Telephon.ini yang akan menyebabkan perubahan kemampuan baris atau alamat yang dilaporkan dalam LINEDEVCAPS atau LINEADDRESSCAPS, atau jika perangkat baris dibuat atau dihapus.

Tidak ada batasan bahwa fungsi ini (TSPI_lineConfigDialog) hanya dipanggil ketika garis ditutup. Namun, setiap penyedia dapat memberlakukan pembatasan seperti itu sendiri. Ketika TSPI_lineConfigDialog dipanggil, penyedia dapat memperingatkan pengguna dengan pesan "Baris sedang digunakan oleh satu atau beberapa aplikasi. Anda tidak boleh mengubah konfigurasi baris saat baris sedang digunakan" (dan mengembalikan pesan kesalahan LINEERR_INUSE). Namun, beberapa konfigurasi mungkin aman untuk mengubah "dengan cepat", terutama yang terkait dengan jenis media (seperti protokol kontrol kesalahan modem), terutama ketika jenis media tersebut saat ini tidak digunakan. Penyedia dapat mengizinkan opsi tersebut diubah saat baris terbuka.

Pengguna tidak boleh diizinkan untuk mengubah apa pun yang mengubah nilai yang dikembalikan dengan LINEDEVCAPS atau LINEADDRESSCAPS tanpa terlebih dahulu menutup baris secara paksa sebagai sinyal bahwa aplikasi harus memanggil fungsi yang mengembalikan struktur ini untuk memiliki informasi yang akurat.