ITBasicCallControl::Transfer 方法 (tapi3if.h)
Transfer 方法會將目前的呼叫傳送至目的地位址。
語法
HRESULT Transfer(
[in] ITBasicCallControl *pCall,
[in] VARIANT_BOOL fSync
);
參數
[in] pCall
為轉移建立之諮詢呼叫的 ITBasicCallControl 介面指標。
[in] fSync
指出方法應該以同步方式完成 (VARIANT_TRUE) 或異步 (VARIANT_FALSE) 。
傳回值
這個方法可以傳回下列其中一個值。
值 | 意義 |
---|---|
|
方法成功。 |
|
pCall 參數不會指向有效的呼叫。 |
|
不支援傳輸。 |
|
記憶體不足,無法執行作業。 |
|
作業失敗,因為 TAPI 3 DLL 已逾時。逾時間隔為兩分鐘。 |
備註
某些服務提供者在串流作用中時不支援此作業。 在作業完成之前,應用程式可能需要先呼叫 ITStream::StopStream 或 ITSubStream::StopSubStream,並在作業完成之後呼叫 ITStream::StartStream::StartSubStream。
通話轉移牽涉到設定諮詢通話,以準備轉移。 pCall 是 ITAddress::CreateCall 在建立諮詢呼叫之後所傳回的 ITBasicCallControl 指標。 ITBasicCallControl::Finish (FM_ASTRANSFER) 完成傳輸。
如果在呼叫 轉移 時,諮詢通話不在 CONNECTED 狀態,TAPI 會使用 (指定的目的地位址,如第一次透過 ITAddress::CreateCall) 建立諮詢通話時指定,並嘗試在該時間連線。 如果原始呼叫具有 NULL 目的地位址, 傳輸 將會失敗,並E_INVALIDARG。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi3if.h (包括 Tapi3.h) |
程式庫 | Uuid.lib |
Dll | Tapi3.dll |