linePrepareAddToConferenceW 函数（tapi.h）

2024-11-20

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

语法

LONG linePrepareAddToConferenceW(
  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 结构中的 dwLineFeatures 成员（类型为 LINEFEATURE）中找到当前有效操作的列表。（调用 lineGetLineDevStatus 更新 LINEDEVSTATUS中的信息。

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

可以使用行投取消咨询电话。也可以申请交换咨询电话和与线的电话会议。

注意

tapi.h 标头将 linePrepareAddToConference 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。