fungsi lineCompleteTransfer (tapi.h)

Artikel
03/08/2023

Fungsi lineCompleteTransfer menyelesaikan transfer panggilan yang ditentukan ke pihak yang terhubung dalam panggilan konsultasi.

Sintaks

LONG lineCompleteTransfer(
  HCALL   hCall,
  HCALL   hConsultCall,
  LPHCALL lphConfCall,
  DWORD   dwTransferMode
);

Parameter

hCall

Tangani ke panggilan yang akan ditransfer. Aplikasi harus menjadi pemilik panggilan ini. Status panggilan hCall harus onHold atau onHoldPendingTransfer.

hConsultCall

Tangani ke panggilan yang mewakili koneksi dengan tujuan transfer. Aplikasi harus menjadi pemilik panggilan ini. Status panggilan hConsultCall harus tersambung, berdering,sibuk, atau melanjutkan.

lphConfCall

Penunjuk ke lokasi memori tempat handel hCall dapat dikembalikan. Jika dwTransferMode LINETRANSFERMODE_CONFERENCE, panggilan konferensi yang baru dibuat dikembalikan di lphConfCall dan aplikasi menjadi pemilik satu-satunya panggilan konferensi. Jika tidak, parameter ini diabaikan oleh TAPI.

dwTransferMode

Bagaimana permintaan transfer yang dimulai akan diselesaikan. Parameter ini menggunakan salah satu konstanta LINETRANSFERMODE_.

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_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCONSULTCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALTRANSFERMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Keterangan

Pesan LINE_REPLY yang dikirim sebagai respons terhadap panggilan ke fungsi lineCompleteTransfer didasarkan pada status panggilan yang ditentukan oleh parameter hCall .

Operasi ini menyelesaikan transfer panggilan asli, hCall, ke pihak yang saat ini terhubung oleh hConsultCall. Panggilan konsultasi biasanya dihubungi pada panggilan konsultasi yang dialokasikan sebagai bagian dari lineSetupTransfer, tetapi dapat berupa panggilan apa pun yang sakelarnya mampu mentransfer hCall.

Permintaan transfer dapat diselesaikan baik sebagai transfer atau sebagai panggilan konferensi tiga arah. Ketika diselesaikan sebagai transfer, pihak yang terhubung oleh hCall dan hConsultCall terhubung satu sama lain, dan hCall dan hConsultCall biasanya dibersihkan dari garis aplikasi dan transisi ke status menganggur . Handel panggilan aplikasi tetap valid setelah transfer selesai. Aplikasi harus membatalkan alokasi handelnya dengan lineDeallocateCall ketika tidak lagi tertarik dengan panggilan yang ditransfer.

Ketika diselesaikan sebagai konferensi, ketiga pihak masuk ke dalam panggilan konferensi. Kedua handel panggilan yang ada tetap valid tetapi transisi ke status konferensi . Handel panggilan konferensi dibuat dan dikembalikan, dan beralih ke status tersambung .

Jika lineGetConfRelatedCalls dipanggil segera setelah lineCompleteTransfer dengan hasil panggilan dikonferensikan, lineGetConfRelatedCalls mungkin tidak mengembalikan daftar lengkap panggilan terkait. Ini karena TAPI menunggu untuk menerima pesan LINE_CALLSTATE yang menunjukkan bahwa panggilan telah masuk LINECALLSTATE_CONFERENCED sebelum menganggap panggilan tersebut benar-benar menjadi bagian dari konferensi. Artinya, menunggu penyedia layanan untuk mengonfirmasi status konferensi. Setelah aplikasi menerima pesan LINE_CALLSTATE, lineGetConfRelatedCalls mengembalikan informasi lengkap.

Dimungkinkan juga untuk melakukan transfer panggilan buta menggunakan lineBlindTransfer.