lineGetConfRelatedCalls 函数 (tapi.h)

项目
03/13/2024

lineGetConfRelatedCalls 函数返回与指定呼叫属于同一电话会议呼叫的呼叫句柄列表。指定的呼叫是电话会议或电话会议中的参与者呼叫。为应用程序尚没有句柄的调用生成新句柄，并授予应用程序对这些调用的监视权限。

语法

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

参数

hCall

调用的句柄。这是电话会议或电话会议中的参与者呼叫。对于会议父呼叫， hCall 的呼叫状态可以是任何状态。对于会议参与者呼叫，它必须处于会议状态。

lpCallList

指向 LINECALLLIST 类型的可变大小数据结构的指针。成功完成请求后，将在此结构中返回对会议呼叫中所有呼叫的呼叫句柄。列表中的第一个呼叫是电话会议，其他呼叫是参与者呼叫。应用程序被授予对尚未具有句柄的调用的监视权限;应用程序已具有句柄的列表中调用的权限保持不变。在调用 lineGetConfRelatedCalls 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

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

返回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOCONFERENCE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注解

指定的呼叫可以是会议呼叫句柄，也可以是参与者呼叫的句柄。例如，尚未添加到电话会议中的咨询呼叫不是会议的一部分。返回的列表中的第一个条目是会议呼叫句柄，其他句柄是所有参与者呼叫。指定的调用始终是列表中返回的调用之一。列表中应用程序尚未具有调用句柄的调用将分配监视权限;对应用程序已具有句柄的调用的特权保持不变。应用程序可以使用 lineSetCallPrivilege 更改调用的权限。

如果在使用 lineCompleteTransfer 将呼叫添加到会议后立即调用 lineGetConfRelatedCalls，lineGetConfRelatedCalls 可能不会返回相关呼叫的完整列表，因为 TAPI 会等待接收LINE_CALLSTATE消息，指示呼叫已进入LINECALLSTATE_CONFERENCED，然后才认为呼叫实际上是会议 (的一部分，即，会议状态由服务提供商) 确认。应用程序收到LINE_CALLSTATE消息后， lineGetConfRelatedCalls 返回完整信息。

应用程序可以为列表中的每个调用调用调用 lineGetCallInfo 和 lineGetCallStatus ，以分别确定调用的信息和状态。