ITBasicCallControl::Metode transfer (tapi3if.h)

Artikel
03/04/2024

Metode Transfer mentransfer panggilan saat ini ke alamat tujuan.

Sintaks

HRESULT Transfer(
  [in] ITBasicCallControl *pCall,
  [in] VARIANT_BOOL       fSync
);

Parameter

[in] pCall

Pointer ke antarmuka ITBasicCallControl dari panggilan konsultasi yang dibuat untuk transfer.

[in] fSync

Menunjukkan apakah metode harus diselesaikan secara sinkron (VARIANT_TRUE) atau secara asinkron (VARIANT_FALSE).

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_INVALIDARG	Parameter pCall tidak menunjuk ke panggilan yang valid.
E_FAIL	Transfer tidak didukung.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.
TAPI_E_TIMEOUT	Operasi gagal karena DLL TAPI 3 kehabisan waktu. Interval batas waktu adalah dua menit.

Keterangan

Beberapa penyedia layanan tidak mendukung operasi ini saat streaming aktif. Aplikasi mungkin perlu memanggil ITStream::StopStream atau ITSubStream::StopSubStream sebelum operasi dan ITStream::StartStream atau ITSubStream::StartSubStream setelah menyelesaikan operasi.

Transfer panggilan melibatkan pengaturan panggilan konsultasi sebagai persiapan untuk transfer. pCall adalah pointer ITBasicCallControl yang dikembalikan oleh ITAddress::CreateCall setelah pembuatan panggilan konsultasi. ITBasicCallControl::Finish (FM_ASTRANSFER) menyelesaikan transfer.

Jika panggilan konsultasi tidak dalam status TERSAMBUNG saat Transfer dipanggil, TAPI akan menggunakan alamat tujuan (seperti yang ditentukan ketika panggilan konsultasi pertama kali dibuat melalui ITAddress::CreateCall) dan mencoba terhubung pada saat itu. Jika panggilan asli memiliki alamat tujuan NULL , Transfer akan gagal dengan E_INVALIDARG.