linePrepareAddToConference 関数 (tapi.h)

[アーティクル]
03/13/2024

linePrepareAddToConference 関数は、別のパーティの追加のために既存の電話会議を準備します。

構文

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

パラメーター

hConfCall

電話会議を処理します。アプリケーションは、この呼び出しの所有者である必要があります。 hConfCall の呼び出し状態は接続されている必要があります。

lphConsultCall

HCALL ハンドルへのポインター。この場所には、追加する相談呼び出しを識別するハンドルが読み込まれます。最初は、アプリケーションがこの呼び出しの唯一の所有者です。

lpCallParams

コンサルテーション呼び出しを確立するときに使用する呼び出しパラメーターを含む LINECALLPARAMS 構造体へのポインター。特別な呼び出しセットアップパラメーターが必要ない場合は、このパラメーターを NULL に設定できます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。関数が成功した場合は、対応するLINE_REPLY メッセージの dwParam2 パラメーターは 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

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 または 3 方向の電話会議として解決される lineCompleteTransfer を使用して取得できます。 linePrepareAddToConference 関数は、通常、既存の電話会議を onHoldPendingConference 状態にし、後で lineAddToConference を使用して既存の電話会議に追加できるコンサルテーション呼び出しを作成します。

lineDrop を使用して、相談呼び出しを取り消すことができます。また、アプリケーションが相談呼び出しと開催された電話会議と lineSwapHold を入れ替えることもできます。