fungsi lineRemoveFromConference (tapi.h)

Artikel
03/08/2023

Fungsi lineRemoveFromConference menghapus panggilan yang ditentukan dari panggilan konferensi tempat saat ini berada. Panggilan yang tersisa dalam panggilan konferensi tidak terpengaruh.

Sintaks

LONG lineRemoveFromConference(
  HCALL hCall
);

Parameter

hCall

Tangani panggilan untuk dihapus dari konferensi. Aplikasi harus menjadi pemilik panggilan ini. Status panggilan hCall harus dikonferensikan.

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

Keterangan

Operasi ini menghapus pihak yang saat ini termasuk dalam panggilan konferensi. Setelah panggilan berhasil dihapus, mungkin untuk memanipulasinya lebih lanjut menggunakan handelnya. Ketersediaan operasi ini dan hasilnya cenderung terbatas dalam banyak implementasi. Misalnya, dalam banyak implementasi, hanya pihak yang terakhir ditambahkan yang dapat dihapus dari konferensi, dan panggilan yang dihapus dapat secara otomatis dihentikan (menjadi menganggur). Lihat kemampuan perangkat saluran untuk menentukan efek yang tersedia dari menghapus panggilan dari konferensi.

Jika penghapusan peserta dari konferensi didukung, peserta memanggil, setelah dihapus dari konferensi, memasuki status panggilan yang tercantum di anggota dwRemoveFromConfState di LINEADDRESSCAPS.