ITBasicCallControl::Metode HandoffDirect (tapi3if.h)

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.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi3if.h (termasuk Tapi3.h)
Pustaka	Uuid.lib
DLL	Tapi3.dll

Lihat juga

Objek Panggilan

Putuskan sambungan

Gambaran umum handoff

ITBasicCallControl

lineHandoff