lineSetNumRings 函数 (tapi.h)

项目
08/26/2023

lineSetNumRings 函数设置在接听传入呼叫之前必须发生的响铃数。此函数可用于实现收费节省型函数。它允许多个独立应用程序分别注册环数。函数行GetNumRings 返回请求的最小环数。应答传入呼叫的应用程序可以使用它来确定在接听呼叫之前应等待的响铃数。

语法

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

参数

hLine

开行设备的句柄。

dwAddressID

线路设备上的地址。地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

dwNumRings

应接听呼叫前的响铃数，以响应来自所有应用程序的收费节省程序请求。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESSID、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注解

lineGetNumRings 和 lineSetNumRings 函数结合使用时，提供一种机制来支持跨多个独立应用程序实现收费节省功能。如果没有应用程序调用 lineSetNumRings，lineGetNumRings 将返回0xFFFFFFFF。

如果应用程序是 处于产品/服务 状态的呼叫的所有者，并且收到 LINE_LINEDEVSTATE响铃消息，则应等待与 lineGetNumRings 返回的号码相等的响铃数，然后才能应答呼叫，以便在所有应用程序中遵循通行费节省设置。每个响铃周期都会向应用程序发送单独的LINE_LINEDEVSTATE响铃消息，因此应用程序应对这些消息进行计数。如果此呼叫在接听之前断开连接，并且随后不久又发出另一个呼叫，则 LINE_CALLSTATE 消息应允许应用程序确定响铃与第二个呼叫相关。

如果 TAPI 通过应答未知媒体类型的传入呼叫并筛选媒体流来执行呼叫分类，则 TAPI 也遵循此号码。

注意此操作纯粹是信息性的，不会影响线路设备上任何调用的状态。