fungsi lineSetAppSpecific (tapi.h)

Artikel
03/04/2024

Fungsi lineSetAppSpecific memungkinkan aplikasi untuk mengatur bidang khusus aplikasi dari rekaman informasi panggilan yang ditentukan.

Sintaks

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

Parameter

hCall

Tangani ke panggilan yang bidang khusus aplikasinya perlu diatur. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall dapat menjadi status apa pun.

dwAppSpecific

Konten baru anggota dwAppSpecific untuk struktur LINECALLINFO panggilan. Nilai ini tidak ditafsirkan oleh API Telepon.

Nilai kembali

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

LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

Keterangan

Bidang khusus aplikasi dalam struktur data LINECALLINFO yang ada untuk setiap panggilan tidak ditafsirkan oleh API Telepon atau penyedia layanannya. Penggunaannya sepenuhnya ditentukan oleh aplikasi. Bidang dapat dibaca dari rekaman LINECALLINFO yang dikembalikan oleh lineGetCallInfo. Namun, lineSetAppSpecific harus digunakan untuk mengatur bidang sehingga perubahan menjadi terlihat oleh aplikasi lain. Ketika bidang ini diubah, semua aplikasi lain dengan handel panggilan dikirimi pesan LINE_CALLINFO dengan indikasi bahwa anggota dwAppSpecific telah berubah.