itBasicCallControl：：Transfer 方法 (tapi3if.h)

项目
03/05/2024

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：：StopStream 或 ITSubStream：：StopSubStream ，并在操作完成后调用 ITStream：：StartStream 或 ITSubStream：：StartSubStream 。

呼叫转移涉及设置咨询呼叫，以准备转接。 pCall 是创建咨询调用后由 ITAddress：：CreateCall 返回的 ITBasicCallControl 指针。 ITBasicCallControl：：Finish (FM_ASTRANSFER) 完成传输。

如果在调用 Transfer 时咨询呼叫未处于 CONNECTED 状态，TAPI 将使用首次通过 ITAddress：：CreateCall) 创建咨询呼叫时指定的目标地址 (，并尝试在此时进行连接。如果原始调用的目标地址为 NULL ， 则转移 将失败并E_INVALIDARG。