fungsi lineGetStatusMessages (tapi.h)

Artikel
03/04/2024

Fungsi lineGetStatusMessages memungkinkan aplikasi untuk mengkueri pesan pemberitahuan mana yang disiapkan aplikasi untuk menerima peristiwa yang terkait dengan perubahan status untuk baris yang ditentukan atau alamatnya.

Sintaks

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

Parameter

hLine

Tangani ke perangkat baris.

lpdwLineStates

Array bit yang mengidentifikasi status perangkat baris mana yang mengubah pesan akan dikirim ke aplikasi. Jika bendera TRUE, pesan tersebut diaktifkan; jika FALSE, maka akan dinonaktifkan. Parameter ini menggunakan satu atau beberapa konstanta LINEDEVSTATE_.

lpdwAddressStates

Array bit yang mengidentifikasi status alamat mana yang mengubah pesan akan dikirim ke aplikasi. Jika bendera TRUE, pesan tersebut diaktifkan; jika FALSE, dinonaktifkan. Parameter ini menggunakan satu atau beberapa konstanta LINEADDRESSSTATE_.

Nilai kembali

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

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 status alamat dan baris. Fungsi lineSetStatusMessages dapat digunakan untuk memilih pesan mana yang ingin diterima aplikasi. Secara default, status alamat dan pelaporan status baris dinonaktifkan.