lineHold 函数 (tapi.h)

项目
03/02/2024

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

语法

LONG lineHold(
  HCALL hCall
);

参数

hCall

要置于保留状态的调用的句柄。应用程序必须是呼叫的所有者。 hCall 的调用状态必须已连接。

返回值

如果函数以异步方式完成，则返回一个正请求标识符;如果发生错误，则返回负错误号。如果函数成功，则相应LINE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。可能的返回值为：

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

注解

暂停呼叫暂时断开连接，允许应用程序使用线路设备进行其他呼叫或应答。 lineHold 函数执行指定的调用 (的所谓“硬保持”，而不是 ) 的“咨询调用”。硬保持呼叫通常不能转移或包含在电话会议中，但咨询呼叫可以。咨询调用是使用 lineSetupTransfer、 lineSetupConference 或 linePrepareAddToConference 发起的。

成功将呼叫置于保留状态后，调用状态通常会转换为 onHold。保留的调用由 lineUnhold 检索。当呼叫处于暂停状态时，应用程序可以接收有关保留调用状态更改 LINE_CALLSTATE 消息。例如，如果被保留方挂起，则呼叫状态可能会转换为 断开连接。

在桥接的情况下， lineHold 操作实际上可能不会将呼叫置于保留状态，因为呼叫上其他电台的状态可以控制 (例如，尝试在其他电台参与时“保持”呼叫是不可能的) ：相反，如果呼叫在其他工作站保持连接，则只需将其更改为LINECONNECTEDMODE_INACTIVE模式。