lineRedirectA 函数 (tapi.h)

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

语法

LONG lineRedirectA(
  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接听呼叫。 这些操作的可用性取决于设备功能。

注意

tapi.h 标头将 lineRedirect 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
目标平台 窗户
标头 tapi.h
Tapi32.lib
DLL Tapi32.dll

另请参阅

LINE_REPLY

重定向概述

补充线服务函数

TAPI 2.2 参考概述

lineAccept

lineAnswer

lineDrop