lineRedirect 函数 (tapi.h)

lineRedirect 函数将指定的产品/服务调用重定向到指定的目标地址。

语法

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

参数

hCall

要重定向的调用的句柄。 应用程序必须是呼叫的所有者。 必须提供hCall 的调用状态。

lpszDestAddress

指向目标地址的指针。 这遵循标准可拨号号码格式。

dwCountryCode

呼叫重定向到的参与方的国家/地区代码。 如果指定值 0，则实现将使用默认值。

返回值

如果函数以异步方式完成，则返回一个正请求标识符;如果发生错误，则返回负错误号。 如果函数成功，则相应LINE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。 可能的返回值为：

LINEERR_INVALADDRESS、LINEERR_NOTOWNER、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALCOUNTRYCODE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

注解

呼叫重定向允许应用程序将产品/服务呼叫转接到另一个地址，而无需先接听呼叫。 呼叫重定向与呼叫转接的不同之处在于，呼叫转接由交换机执行，而不涉及应用程序;重定向可以由应用程序按调用完成，例如，由调用方 ID 信息驱动。 它与呼叫转移的不同之处在于，转接呼叫需要首先接听呼叫。

成功重定向呼叫后，调用通常会转换为空闲状态。

除了重定向传入呼叫外，应用程序还可以选择使用 lineAccept 接受呼叫、使用 lineDrop 拒绝呼叫或使用 lineAnswer 应答呼叫。 这些操作的可用性取决于设备功能。

要求

要求	值
目标平台	Windows
标头	tapi.h
Library	Tapi32.lib
DLL	Tapi32.dll

另请参阅

LINE_REPLY

重定向概述

补充行服务函数

TAPI 2.2 参考概述

lineAccept

lineAnswer

lineDrop