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_USERUSERINFOTOOBIGLINEERR_INVALMEDIAMODE，LINEERR_UNINITIALIZED。

備註

如果傳回LINEERR_INVALLINESTATE，則行目前不是可執行此作業的狀態。目前有效的作業清單可以在LINEDEVSTATUS結構的LINEFEATURE類型 (的 dwLineFeatures 成員) 中找到。 (呼叫 lineGetLineDevStatus 會更新 LINEDEVSTATUS.)

您可以使用 lineSetupConference 取得會議通話句柄，或使用已解析為三向會議通話的 lineCompleteTransfer 。 linePrepareAddToConference 函式通常會將現有的電話放在 onHoldPendingConference 狀態，並建立稍後可以使用 lineAddToConference 新增至現有會議通話的諮詢通話。

您可以使用 lineDrop 取消諮詢通話。應用程式也可以透過 lineSwapHold在諮詢通話與保留的電話之間交換。