Share via

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

另请参阅

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineCloseCall