fungsi lineSetStatusMessages (tapi.h)

Artikel
03/02/2024

Fungsi lineSetStatusMessages memungkinkan aplikasi menentukan pesan pemberitahuan mana yang akan diterima untuk peristiwa yang terkait dengan perubahan status untuk baris yang ditentukan atau alamatnya.

Sintaks

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

Parameter

hLine

Tangani ke perangkat baris.

dwLineStates

Array bit yang mengidentifikasi status perangkat baris mana yang mengubah pesan akan dikirim ke aplikasi. Parameter ini menggunakan satu atau beberapa konstanta LINEDEVSTATE_.

dwAddressStates

Array bit yang mengidentifikasi status alamat mana yang mengubah pesan akan dikirim ke aplikasi. Parameter ini menggunakan satu atau beberapa konstanta LINEADDRESSSTATE_.

Nilai kembali

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

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

Keterangan

TAPI mendefinisikan sejumlah pesan yang memberi tahu aplikasi tentang peristiwa yang terjadi pada baris dan alamat. Aplikasi mungkin tidak tertarik untuk menerima semua pesan perubahan alamat dan status baris. Fungsi lineSetStatusMessages dapat digunakan untuk memilih pesan mana yang diterima aplikasi. Secara default, pelaporan status alamat dan baris dinonaktifkan.