linePrepareAddToConferenceA 函式（tapi.h）

linePrepareAddToConference 函式會準備現有會議來加入另一方。

語法

LONG linePrepareAddToConferenceA(
  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 結構中，可以在 dwLineFeatures 成員中找到目前有效作業的清單（類型 LINEFEATURE]。（呼叫 lineGetLineDevStatus 更新 lineDEVSTATUS 中的資訊。

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

諮詢電話可以使用線線取消。您也可以申請與線的會晤和召開的電話交換。

注意

tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 linePrepareAddToConference 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。