ITBasicCallControl::Transfer 方法 (tapi3if.h)

Transfer 方法會將目前的呼叫傳送至目的地位址。

語法

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

參數

[in] pCall

為轉移建立之諮詢呼叫的 ITBasicCallControl 介面指標。

[in] fSync

指出方法應該以同步方式完成 (VARIANT_TRUE) 或異步 (VARIANT_FALSE) 。

傳回值

這個方法可以傳回下列其中一個值。

意義
S_OK
方法成功。
E_INVALIDARG
pCall 參數不會指向有效的呼叫。
E_FAIL
不支援傳輸。
E_OUTOFMEMORY
記憶體不足,無法執行作業。
TAPI_E_TIMEOUT
作業失敗,因為 TAPI 3 DLL 已逾時。逾時間隔為兩分鐘。

備註

某些服務提供者在串流作用中時不支援此作業。 在作業完成之前,應用程式可能需要先呼叫 ITStream::StopStreamITSubStream::StopSubStream,並在作業完成之後呼叫 ITStream::StartStream::StartSubStream

通話轉移牽涉到設定諮詢通話,以準備轉移。 pCallITAddress::CreateCall 在建立諮詢呼叫之後所傳回的 ITBasicCallControl 指標。 ITBasicCallControl::Finish (FM_ASTRANSFER) 完成傳輸。

如果在呼叫 轉移 時,諮詢通話不在 CONNECTED 狀態,TAPI 會使用 (指定的目的地位址,如第一次透過 ITAddress::CreateCall) 建立諮詢通話時指定,並嘗試在該時間連線。 如果原始呼叫具有 NULL 目的地位址, 傳輸 將會失敗,並E_INVALIDARG。

規格需求

需求
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

呼叫物件

會議

[完成]

ITAddress::CreateCall

ITBasicCallControl

傳輸概觀