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 |