TSPI_lineRedirect 函数 (tspi.h)

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

语法

LONG TSPIAPI TSPI_lineRedirect(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

参数

dwRequestID

异步请求的标识符。

hdCall

要重定向的调用的句柄。 hdCall 的呼叫状态可以提供

lpszDestAddress

指向以 null 结尾的 Unicode 字符串的指针,该字符串指定目标地址。 这遵循标准链接格式。

dwCountryCode

呼叫重定向到的参与方的国家或地区代码。 如果指定值 0,则实现将使用默认值。 调用此函数时,TAPI 不会验证此参数。

返回值

如果发生错误,则返回 dwRequestID 或错误号。 如果函数成功,相应ASYNC_COMPLETIONlResult 实际参数为零;如果发生错误,则为错误号。 可能的返回值如下所示:

LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCOUNTRYCODE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL。

注解

如果服务提供程序返回LINEERR_INVALADDRESS,则不会重定向调用。

调用此函数时,服务提供商会将产品/服务调用偏转到另一个地址,而无需先应答呼叫。 呼叫重定向与呼叫转接的不同之处在于,呼叫转接由交换机执行,而不涉及被叫方工作站;重定向可以由客户端应用程序逐个调用完成,例如由调用方 ID 信息驱动。 它不同于呼叫转接,转接呼叫需要首先接听呼叫。

成功重定向呼叫后,调用通常会转换为 空闲状态。 服务提供商使用 LINE_CALLSTATE 消息指示新状态。

要求

要求
目标平台 Windows
标头 tspi.h

另请参阅

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineAccept

TSPI_lineDrop

TSPI_lineGetDevCaps