ITBasicCallControl::Metode HandoffDirect (tapi3if.h)

Artikel
03/02/2024

Metode HandoffDirect menyerahkan panggilan ke aplikasi lain. Ini menunjukkan bahwa aplikasi tidak lagi memerlukan kepemilikan panggilan.

Sintaks

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Parameter

[in] pApplicationName

Pointer ke BSTR yang berisi nama aplikasi tertentu untuk dihubungi. Dapat berupa nama jalur lengkap atau nama yang dapat dieksekusi.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.
E_POINTER	Parameter pApplicationName bukan penunjuk yang valid.

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.

Jika aplikasi penerima belum membuka baris untuk jenis media yang terlibat dalam panggilan, handoff akan gagal. Jika TAPI gagal menyerahkan panggilan, TAPI akan memanggil Putuskan sambungan.

Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk parameter pApplicationName dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.