fungsi lineGetMessage (tapi.h)

Fungsi lineGetMessage mengembalikan pesan TAPI berikutnya yang diantrekan untuk pengiriman ke aplikasi yang menggunakan mekanisme pemberitahuan Penanganan Aktivitas (lihat lineInitializeEx untuk detail lebih lanjut).

Sintaks

LONG lineGetMessage(
  HLINEAPP      hLineApp,
  LPLINEMESSAGE lpMessage,
  DWORD         dwTimeout
);

Parameter

hLineApp

Menangani yang dikembalikan oleh lineInitializeEx. Aplikasi harus mengatur opsi LINEINITIALIZEEXOPTION_USEEVENT di anggota dwOptions dari struktur LINEINITIALIZEEXPARAMS .

lpMessage

Penunjuk ke struktur LINEMESSAGE . Setelah berhasil dikembalikan dari fungsi ini, struktur berisi pesan berikutnya yang telah diantrekan untuk pengiriman ke aplikasi.

dwTimeout

Interval waktu habis, dalam milidetik. Fungsi mengembalikan jika interval berlalu, bahkan jika tidak ada pesan yang dapat dikembalikan. Jika dwTimeout adalah nol, fungsi memeriksa pesan yang diantrekan dan segera kembali. Jika dwTimeout adalah INFINITE, interval waktu habis fungsi tidak pernah berlalu.

Nilai kembali

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

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_NOMEM.

Keterangan

Jika fungsi lineGetMessage telah dipanggil dengan batas waktu non-nol dan aplikasi memanggil lineShutdown pada utas lain, fungsi ini segera kembali dengan LINEERR_INVALAPPHANDLE.

Jika batas waktu berakhir (atau nol) dan tidak ada pesan yang dapat diambil dari antrean, fungsi akan kembali dengan kesalahan LINEERR_OPERATIONFAILED.

Persyaratan

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

Lihat juga

LINEINITIALIZEEXPARAMS

LINEMESSAGE

lineInitializeEx

lineShutdown