TSPI_lineDrop函数 (tspi.h)

项目
03/03/2024

TSPI_lineDrop函数删除或断开指定的调用。用户可以选择将用户信息作为呼叫断开连接的一部分进行传输。应用程序可以随时调用此函数。 当TSPI_lineDrop返回时，调用应处于空闲状态。

语法

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

参数

dwRequestID

异步请求的标识符。

hdCall

要删除的调用的服务提供商句柄。 hdCall 的调用状态可以是除空闲之外的任何状态。

lpsUserUserInfo

仅当 dwSize 为非零时，此指针才有效。它指定指向以 null 结尾的字符串的指针，该字符串包含作为呼叫断开连接的一部分发送到远程方的用户信息。如果未发送用户-用户信息，则此指针为 NULL 。仅当基础网络支持时，才会发送用户-用户信息 (请参阅 LINEDEVCAPS) 。

dwSize

lpsUserUserInfo 中用户-用户信息的大小（以字节为单位）。如果 lpsUserUserInfo 为 NULL，则忽略 dwSize 。

返回值

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

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

注解

如果调用的当前状态不允许丢弃呼叫，则服务提供商将返回LINEERR_INVALCALLSTATE。

调用 TSPI_lineDrop时，相关调用有时也会受到影响。例如，删除电话会议可能会删除所有参与的单个呼叫。对于调用状态受影响的所有呼叫，LINE_CALLSTATE消息将发送到 TAPI。通常，丢弃的调用会转换为空闲状态。调用处于产品/服务状态的呼叫TSPI_lineDrop会拒绝该呼叫。并非所有电话网络都提供此功能。

如果要丢弃的呼叫是在转接或会议呼叫建立期间建立的咨询呼叫，则置于 OnHoldPending 状态的原始呼叫将重新连接到，并且通常会重新进入 连接的 呼叫状态。

TAPI 可以选择在删除时发送用户信息。即使可以发送用户-用户信息，也不能保证网络会将此信息传递给远程方。

注意在多个参与方进行呼叫时的各种桥接或群线配置中， TSPI_lineDrop 实际上可能无法清除呼叫。