ITAddress：：Forward 方法 (tapi3if.h)

项目
08/26/2023

Forward 方法根据 ITForwardInformation 中包含的转发指令转发目标地址的调用。如果 pForwardInfo 设置为 NULL，则取消转发。

语法

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

参数

[in] pForwardInfo

指向 ITForwardInformation 接口的指针，或设置为 NULL 以取消转发。

[in] pCall

指向咨询呼叫的 ITBasicCallControl 接口的指针（如果电话环境需要）。如果不需要，可能为 NULL 。

返回值

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	地址不支持转发，或者 pCall 不指向有效的呼叫。
E_OUTOFMEMORY	内存不足，无法执行操作。
E_POINTER	pForwardInfo 或 pCall 参数不是有效的指针。
TAPI_E_TIMEOUT	操作失败，因为 TAPI 3 DLL 将其超时。超时间隔为两分钟。
LINEERR_	有关从此 TAPI 2.1 函数返回的错误代码，请参阅 LineForward 。

注解

pForwardInfo 中的信息将替代先前的任何转发指令。

如果在将 fDoNotDisturb 设置为 VARIANT_FALSE 的情况下调用 ITAddress：:p ut_DoNotDisturb，则取消所有转发。

应用程序可以通过调用 ITAddressCapabilities：：get_AddressCapability (AC_ADDRESSCAPFLAGS、plCapability) 并检查是否已在 plCapability 中设置了标志LINEADDRCAPFLAGS_FWDCONSULT（LINEADDRCAPFLAGS_常量的成员）来确定是否需要非 NULL 咨询调用。如果已设置，则 Forward 方法的 pCall 参数需要非 NULL 值。

Forward 方法在一定程度上是 TAPI 2.1 LineForward 函数的 COM 包装器。