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 |