Bagikan melalui


fungsi lineGetStatusMessages (tapi.h)

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.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

Referensi Layanan Telepon Dasar

LINE_CLOSE

LINE_LINEDEVSTATE

Gambaran Umum Referensi TAPI 2.2

lineSetStatusMessages