lineGetNewCalls 函数 (tapi.h)

项目
08/26/2023

lineGetNewCalls 函数返回对应用程序当前没有句柄的指定行或地址上的调用的调用句柄。向应用程序授予对这些调用的监视权限。

语法

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

参数

hLine

开行设备的句柄。

dwAddressID

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

dwSelect

选择请求的调用。此参数只使用一个 LINECALLSELECT_常量。

lpCallList

指向 LINECALLLIST 类型的可变大小数据结构的指针。成功完成请求后，将在此结构中返回所有选定调用的调用句柄。在调用 lineGetNewCalls 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

注意如果结构中的大小参数不正确，则有可能覆盖数据。有关设置结构大小的详细信息，请参阅内存分配主题。

返回值

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

LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSELECT、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

注解

应用程序可以使用 lineGetNewCalls 获取其当前没有句柄的调用的句柄。应用程序可以选择要返回句柄的调用，方法是将此选择基于范围 (指定行上的调用，或基于指定地址的调用) 。例如，应用程序可以请求对给定地址上当前没有句柄的所有调用的调用句柄。始终向应用程序授予对新调用句柄的监视权限。此外，在打开行时，应用程序使用此函数来识别现有调用。

应用程序可以为列表中的每个调用调用 lineGetCallInfo 和 lineGetCallStatus ，以便分别确定调用的信息和状态。它可以使用 lineSetCallPrivilege 将其权限更改为所有者。