TSPI_lineHold 函数 (tspi.h)

项目
08/26/2023

TSPI_lineHold 函数将指定的调用置于保留状态。

语法

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

参数

dwRequestID

异步请求的标识符。

hdCall

服务提供商对要置于保留状态的调用的句柄。 hdCall 的呼叫状态可以连接。

返回值

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

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

注解

保持呼叫暂时断开连接，允许 TAPI 使用线路设备进行其他呼叫或接听。 TSPI_lineHold 执行指定呼叫的 硬保留 ，而不是 咨询呼叫。硬保持呼叫通常不能转移或包含在电话会议中，而咨询呼叫可以。咨询电话使用 TSPI_lineSetupTransfer、 TSPI_lineSetupConference或 TSPI_linePrepareAddToConference发起。

成功将呼叫置于保留状态后，调用状态通常会转换为 onHold。通过 TSPI_lineUnhold检索保留的调用。当呼叫处于保留状态时，服务提供商可以发送有关保留呼叫状态更改 LINE_CALLSTATE 消息。例如，如果被保留方挂起，则呼叫状态可以转换为 断开连接，服务提供商可以发送指示新状态的LINE_CALLSTATE消息。