linePrepareAddToConference 函数 (tapi.h)

项目
03/02/2024

linePrepareAddToConference 函数为添加另一方准备现有的电话会议。

语法

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

参数

hConfCall

电话会议句柄。应用程序必须是此调用的所有者。 hConfCall 的调用状态必须已连接。

lphConsultCall

指向 HCALL 句柄的指针。然后，此位置会加载一个句柄，用于标识要添加的咨询呼叫。最初，应用程序是此调用的唯一所有者。

lpCallParams

指向 LINECALLPARAMS 结构的指针，该结构包含建立咨询调用时要使用的调用参数。如果不需要特殊的调用设置参数，则可以将此参数设置为 NULL 。

返回值

如果函数以异步方式完成，则返回一个正请求标识符;如果发生错误，则返回负错误号。如果函数成功，则相应LINE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。可能的返回值为：

LINEERR_BEARERMODEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_CALLUNAVAIL、LINEERR_INVALRATE、LINEERR_CONFERENCEFULL、LINEERR_NOMEM、LINEERR_INUSE、LINEERR_NOTOWNER、LINEERR_INVALADDRESSMODE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALBEARERMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLPARAMS、LINEERR_RATEUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALCONFCALLHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALLINESTATE、LINEERR_USERUSERINFOTOOBIG、LINEERR_INVALMEDIAMODE，LINEERR_UNINITIALIZED。

注解

如果返回LINEERR_INVALLINESTATE，则表示行当前未处于可执行此操作的状态。可以在 LINEDEVSTATUS 结构中 LINEFEATURE) 的 dwLineFeatures 成员 (中找到当前有效操作的列表。 (呼叫线路GetLineDevStatus 更新 LINEDEVSTATUS.)

可以使用 lineSetupConference 或 lineCompleteTransfer （解析为三向电话会议）获取会议呼叫句柄。 linePrepareAddToConference 函数通常将现有的电话会议置于 onHoldPendingConference 状态，并创建一个咨询呼叫，稍后可以使用 lineAddToConference 添加到现有电话会议。

可以使用 lineDrop 取消咨询呼叫。应用程序还可以使用 lineSwapHold 在咨询呼叫和已举行的电话会议之间交换。