TSPI_lineBlindTransfer 函数 (tspi.h)
TSPI_lineBlindTransfer 函数执行对指定目标地址的指定调用的盲目或单步传输。
语法
LONG TSPIAPI TSPI_lineBlindTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
参数
dwRequestID
异步请求的标识符。
hdCall
服务提供商对要转移的调用的句柄。 hdCall 的呼叫状态可以连接。
lpszDestAddress
指向以 null 结尾的 Unicode 字符串的指针,标识调用将传输到何处。 目标地址使用标准可拨号号码格式。
dwCountryCode
目标的国家或地区代码。 实现应使用此来选择目标地址的呼叫进度协议。 如果指定值 0,则服务提供商应使用默认值。 调用此函数时,TAPI 不验证 dwCountryCode 。
返回值
如果发生错误,则返回 dwRequestID 或错误号。 如果函数成功,相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误,则为错误号。 可能的返回值如下所示:
LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESS、LINEERR_OPERATIONFAILED、LINEERR_ADDRESSBLOCKED、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALCOUNTRYCODE。
注解
如果服务提供商返回LINEERR_INVALADDRESS,则不执行拨号。
盲转与咨询转移的区别在于,TAPI 不显示任何咨询呼叫。 通常,在盲转成功完成后,指定的调用将从它所打开的行中清除,并转换为 空闲 状态。 服务提供商的调用句柄必须在传输完成后保持有效。 TAPI 使此句柄在不再对使用 TSPI_lineCloseCall 的转移呼叫感兴趣时失效。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |