fungsi lineDrop (tapi.h)

Artikel
03/13/2024

Fungsi lineDrop menghilangkan atau memutuskan sambungan panggilan yang ditentukan. Aplikasi ini memiliki opsi untuk menentukan informasi pengguna-pengguna yang akan dikirimkan sebagai bagian dari pemutusan panggilan.

Sintaks

LONG lineDrop(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parameter

hCall

Tangani ke panggilan yang akan dihilangkan. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall dapat menjadi status apa pun kecuali diam.

lpsUserUserInfo

Penunjuk ke string yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh sebagai bagian dari pemutusan panggilan. Penunjuk ini dapat dibiarkan NULL jika tidak ada informasi pengguna-pengguna yang akan dikirim. Informasi pengguna hanya dikirim jika didukung oleh jaringan yang mendasarinya (lihat LINEDEVCAPS). Bidang diskriminator protokol untuk informasi pengguna-pengguna, jika diperlukan, akan muncul sebagai byte pertama dari buffer yang ditunjukkan oleh lpsUserUserInfo, dan harus diperbantukan dalam dwSize.

dwSize

Ukuran informasi pengguna-pengguna di lpsUserUserInfo, dalam byte. Jika lpsUserUserInfoadalah NULL, tidak ada informasi pengguna-pengguna yang dikirim ke pihak pemanggil dan dwSize diabaikan.

Mengembalikan 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_OPERATIONUNAVAIL, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED.

Keterangan

Saat memanggil lineDrop, panggilan terkait terkadang juga dapat terpengaruh. Misalnya, menghilangkan panggilan konferensi dapat menghilangkan semua panggilan yang berpartisipasi individu. LINE_CALLSTATE pesan dikirim ke aplikasi untuk semua panggilan yang status panggilannya terpengaruh. Panggilan yang dihentikan biasanya beralih ke status diam . Memanggil lineDrop pada panggilan dalam status penawaran menolak panggilan. Tidak semua jaringan telepon menyediakan kemampuan ini.

Panggilan dalam status onholdpending biasanya kembali ke status tersambung . Saat menghilangkan panggilan konsultasi ke pihak ketiga untuk panggilan konferensi atau saat menghapus pihak ketiga dalam panggilan konferensi yang dibuat sebelumnya, penyedia (dan sakelar) dapat melepaskan jembatan konferensi dan mengembalikan panggilan kembali ke panggilan dua pihak normal. Jika demikian, hConfCall beralih ke status menganggur , dan satu-satunya transisi panggilan yang berpartisipasi yang tersisa ke status tersambung . Beberapa sakelar secara otomatis "membatalkan ajakan" panggilan lainnya.

Aplikasi ini memiliki opsi untuk mengirim informasi pengguna-pengguna pada saat pengantaran. Bahkan jika informasi pengguna-pengguna dapat dikirim, tidak ada jaminan bahwa jaringan akan mengirimkan informasi ini ke pihak jarak jauh.

Dalam berbagai konfigurasi garis jembatan atau pihak ketika beberapa pihak sedang dalam panggilan, lineDrop mungkin tidak benar-benar menghapus panggilan. Misalnya, dalam situasi yang dihubungi, operasi lineDrop mungkin tidak benar-benar menghilangkan panggilan karena status stasiun lain pada panggilan dapat mengatur; sebaliknya, panggilan hanya dapat diubah ke mode LINECONNECTEDMODE_INACTIVE jika tetap terhubung di stasiun lain.