lineDrop 函数 (tapi.h)

项目
08/26/2023

lineDrop 函数删除或断开指定的调用。应用程序可以选择指定要在呼叫断开连接过程中传输的用户-用户信息。

语法

LONG lineDrop(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

参数

hCall

要丢弃的调用的句柄。应用程序必须是调用的所有者。 hCall 的调用状态可以是除空闲之外的任何状态。

lpsUserUserInfo

指向字符串的指针，该字符串包含要作为呼叫断开连接的一部分发送到远程方的用户信息。如果未发送用户用户信息，则此指针可以为 NULL 。仅当基础网络支持时，才会发送用户-用户信息 (请参阅 LINEDEVCAPS) 。用户-用户信息的协议鉴别器字段（如果需要）应显示为 lpsUserUserInfo 指向的缓冲区的第一个字节，并且必须在 dwSize 中进行考虑。

dwSize

lpsUserUserInfo 中用户信息的大小（以字节为单位）。如果 lpsUserUserInfo 为 NULL，则不会向调用方发送任何用户-用户信息，并忽略 dwSize 。

返回值

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

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

注解

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

处于 onholdpending 状态的 调用通常还原为连接状态。将咨询呼叫拨给第三方进行电话会议时，或者在以前建立的电话会议中删除第三方时，提供商 (并切换) 可以释放会议网桥，并将呼叫还原回正常的两方呼叫。如果是这种情况， 则 hConfCall 将转换为空闲状态，而仅剩余参与的呼叫将转换为连接状态。某些开关会自动“取消”另一个调用。

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

在多个参与方进行呼叫时的各种桥接或群线配置中， lineDrop 实际上可能无法清除呼叫。例如，在桥接的情况下， lineDrop 操作实际上可能不会删除呼叫，因为呼叫上其他工作站的状态可能受控制;相反，如果呼叫在其他工作站保持连接，则只需更改为LINECONNECTEDMODE_INACTIVE模式。