METODE ITBasicCallControl::BlindTransfer (tapi3if.h)

Artikel
03/02/2024

Metode BlindTransfer melakukan transfer buta atau satu langkah dari panggilan yang ditentukan ke alamat tujuan yang ditentukan. Aplikasi harus menjadi pemilik panggilan. Setelah transfer berhasil, status panggilan beralih ke CS_DISCONNECTED.

Sintaks

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

Parameter

[in] pDestAddress

Pointer ke BSTR yang berisi alamat tujuan untuk transfer.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	pDestAddress bukan penunjuk yang valid.
E_FAIL	Transfer buta tidak didukung.
E_OUTOFMEMORY	Tidak ada cukup memori 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.

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

Dalam beberapa kasus, aplikasi mungkin perlu menggunakan antarmuka terjemahan alamat ( ITAddressTranslation dan ITAddressTranslationInfo) untuk mendapatkan string pDestAddress dalam format yang tepat.