fungsi lineGetConfRelatedCalls (tapi.h)

Artikel
08/26/2023

Fungsi lineGetConfRelatedCalls mengembalikan daftar handel panggilan yang merupakan bagian dari panggilan konferensi yang sama dengan panggilan yang ditentukan. Panggilan yang ditentukan adalah panggilan konferensi atau panggilan peserta dalam panggilan konferensi. Handel baru dihasilkan untuk panggilan yang belum ditangani aplikasi, dan aplikasi diberikan hak istimewa monitor untuk panggilan tersebut.

Sintaks

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Parameter

hCall

Menangani panggilan. Ini adalah panggilan konferensi atau panggilan peserta dalam panggilan konferensi. Untuk panggilan induk konferensi, status panggilan hCall dapat menjadi status apa pun. Untuk panggilan peserta konferensi, panggilan harus dalam status konferensi .

lpCallList

Penunjuk ke struktur data berukuran bervariasi dari jenis LINECALLLIST. Setelah berhasil menyelesaikan permintaan, handel panggilan ke semua panggilan dalam panggilan konferensi dikembalikan dalam struktur ini. Panggilan pertama dalam daftar adalah panggilan konferensi, panggilan lainnya adalah panggilan peserta. Aplikasi diberikan hak istimewa monitor untuk panggilan yang belum memiliki handel; hak istimewa untuk panggilan dalam daftar yang sudah ditangani aplikasi tidak berubah. Sebelum memanggil lineGetConfRelatedCalls, aplikasi harus mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Catatan Jika parameter ukuran dalam struktur tidak benar, ada kemungkinan data bisa ditimpa. Untuk informasi selengkapnya tentang pengaturan ukuran struktur, lihat topik alokasi memori .

Mengembalikan nilai

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Panggilan yang ditentukan dapat berupa handel panggilan konferensi atau handel untuk panggilan peserta. Misalnya, panggilan konsultasi yang belum ditambahkan ke panggilan konferensi bukan bagian dari konferensi. Entri pertama dalam daftar yang dikembalikan adalah handel panggilan konferensi, handel lainnya adalah semua panggilan peserta. Panggilan yang ditentukan selalu merupakan salah satu panggilan yang dikembalikan dalam daftar. Panggilan dalam daftar di mana aplikasi belum memiliki handel panggilan diberi hak istimewa monitor; hak istimewa untuk panggilan yang sudah ditangani aplikasi tidak berubah. Aplikasi dapat menggunakan lineSetCallPrivilege untuk mengubah hak istimewa panggilan.

Jika lineGetConfRelatedCalls dipanggil segera setelah panggilan ditambahkan ke konferensi menggunakan lineCompleteTransfer, lineGetConfRelatedCalls mungkin tidak mengembalikan daftar lengkap panggilan terkait karena TAPI menunggu untuk menerima pesan LINE_CALLSTATE yang menunjukkan bahwa panggilan telah memasuki LINECALLSTATE_CONFERENCED sebelum menganggap panggilan benar-benar menjadi bagian dari konferensi (yaitu, status konferensi dikonfirmasi oleh penyedia layanan). Setelah aplikasi menerima pesan LINE_CALLSTATE, lineGetConfRelatedCalls mengembalikan informasi lengkap.

Aplikasi dapat memanggil lineGetCallInfo dan lineGetCallStatus untuk setiap panggilan dalam daftar untuk menentukan informasi dan status panggilan.