fungsi lineConfigDialog (tapi.h)

Artikel
03/08/2023

Fungsi lineConfigDialog menyebabkan penyedia perangkat baris yang ditentukan menampilkan kotak dialog (dilampirkan ke hwndOwner aplikasi) untuk memungkinkan pengguna mengonfigurasi parameter yang terkait dengan perangkat baris.

Sintaks

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parameter

dwDeviceID

Pengidentifikasi perangkat baris yang akan dikonfigurasi.

hwndOwner

Tangani ke jendela tempat kotak dialog akan dilampirkan. Dapat berupa NULL untuk menunjukkan bahwa setiap jendela yang dibuat selama fungsi seharusnya tidak memiliki jendela pemilik.

lpszDeviceClass

Penunjuk ke string yang dihentikan null yang mengidentifikasi nama kelas perangkat. Kelas perangkat ini memungkinkan aplikasi untuk memilih sub-layar tertentu dari informasi konfigurasi yang berlaku untuk kelas perangkat tersebut. Parameter ini bersifat opsional dan dapat dibiarkan NULL atau kosong, dalam hal ini konfigurasi tingkat tertinggi dipilih.

Nilai kembali

Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Keterangan

Fungsi lineConfigDialog menyebabkan penyedia layanan menampilkan kotak dialog modal (dilampirkan ke hwndOwner aplikasi) untuk memungkinkan pengguna mengonfigurasi parameter yang terkait dengan baris yang ditentukan oleh dwDeviceID. Parameter lpszDeviceClass memungkinkan aplikasi untuk memilih sub-layar tertentu dari informasi konfigurasi yang berlaku untuk kelas perangkat tempat pengguna tertarik; string yang diizinkan sama dengan untuk lineGetID. Misalnya, jika baris mendukung Comm API, meneruskan "COMM" sebagai lpszDeviceClass menyebabkan penyedia menampilkan parameter yang terkait khusus dengan Comm (atau, setidaknya, mulai dari titik yang sesuai dalam rantai kotak dialog konfigurasi multilevel, sehingga pengguna tidak perlu "menggali" untuk menemukan parameter yang menarik).

Parameter lpszDeviceClass adalah "tapi/line" , "", atau NULL menyebabkan penyedia menampilkan konfigurasi tingkat tertinggi untuk baris.