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_COMPLETION的 lResult 实际参数为零;如果发生错误,则为错误号。 可能的返回值如下所示:
LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCOUNTRYCODE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL。
注解
如果服务提供程序返回LINEERR_INVALADDRESS,则不会重定向调用。
调用此函数时,服务提供商会将产品/服务调用偏转到另一个地址,而无需先应答呼叫。 呼叫重定向与呼叫转接的不同之处在于,呼叫转接由交换机执行,而不涉及被叫方工作站;重定向可以由客户端应用程序逐个调用完成,例如由调用方 ID 信息驱动。 它不同于呼叫转接,转接呼叫需要首先接听呼叫。
成功重定向呼叫后,调用通常会转换为 空闲状态。 服务提供商使用 LINE_CALLSTATE 消息指示新状态。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |