fungsi lineReleaseUserUserInfo (tapi.h)

Artikel
08/26/2023

Fungsi lineReleaseUserUserInfo memberi tahu penyedia layanan bahwa aplikasi telah memproses informasi pengguna yang terkandung dalam struktur LINECALLINFO , dan informasi pengguna-pengguna yang kemudian diterima sekarang dapat ditulis ke dalam struktur tersebut. Penyedia layanan mengirimkan pesan LINE_CALLINFO yang menunjukkan LINECALLINFOSTATE_USERUSERINFO saat informasi baru tersedia.

Sintaks

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Parameter

hCall

Tangani panggilan. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall dapat menjadi status apa pun.

Menampilkan nilai

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

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

Keterangan

Fungsi lineReleaseUserUserInfo memungkinkan aplikasi mengontrol alur informasi pengguna-pengguna masuk pada koneksi ISDN. Ketika pesan informasi pengguna baru dan lengkap diterima, penyedia layanan menginformasikan aplikasi menggunakan pesan LINE_CALLINFO (menentukan LINECALLINFOSTATE_USERUSERINFO). Sejumlah aplikasi dapat memeriksa informasi (menggunakan lineGetCallInfo), tetapi aplikasi yang memiliki kontrol panggilan ketika informasi dirilis sehingga informasi berikutnya dapat dilaporkan. Penyedia layanan tidak akan menimpa informasi pengguna-pengguna sebelumnya di LINECALLINFO dengan informasi yang lebih baru sampai setelah lineReleaseUserUserInfo dipanggil. Penyedia layanan bertanggung jawab untuk buffer kemudian menerima informasi pengguna-pengguna sampai informasi sebelumnya dirilis oleh aplikasi yang memiliki panggilan.