lineGetNumRings 函数 （tapi.h）
lineGetNumRings 函数确定在接听呼叫之前，给定地址上传入呼叫应响铃的圈数。
语法
LONG lineGetNumRings(
HLINE hLine,
DWORD dwAddressID,
LPDWORD lpdwNumRings
);
参数
hLine
打开行设备的句柄。
dwAddressID
线路设备上的地址。 地址标识符永久关联到地址;标识符在操作系统升级中保持不变。
lpdwNumRings
是所有当前 lineSetNumRings 请求的最小环数。
返回值
如果请求成功，则返回零;如果发生错误，则返回负错误号。 可能的返回值为：
LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。
言论
lineGetNumRings 和 lineSetNumRings 函数结合使用时，提供一种机制来支持跨多个独立应用程序实现收费保护程序功能。
接收 中呼叫句柄的应用程序 状态和 LINE_LINEDEVSTATE响铃 消息应在接听呼叫之前等待与 lineGetNumRings 返回的数字相等的多个环，然后再接听呼叫，以便跨所有应用程序执行收费保护程序设置。 lineGetNumRings 函数返回由 lineSetNumRings指定的所有应用程序环数的最小值。 由于此数字可能会动态变化，因此应用程序应在每次可以选择接听呼叫时调用 lineGetNumRings。 如果没有应用程序调用 lineSetNumRings，则返回的环数0xFFFFFFFF。 为每个环形周期向应用程序发送单独的LINE_LINEDEVSTATE 响铃 消息。
如果 TAPI 执行呼叫分类以应答未知媒体模式的所有呼叫并筛选媒体流，TAPI 也遵循此号码。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 窗户 |
| 标头 | tapi.h |
| 库 | Tapi32.lib |
| DLL | Tapi32.dll |