lineAddToConference 関数 (tapi.h)

[アーティクル]
08/26/2023

lineAddToConference 関数は、hConsultCall で指定された呼び出しを hConfCall で指定された電話会議に追加します。

構文

LONG lineAddToConference(
  HCALL hConfCall,
  HCALL hConsultCall
);

パラメーター

hConfCall

電話会議を処理します。アプリケーションは、この呼び出しの所有者である必要があります。電話会議の監視 (メディア、トーン、数字) は hConfCall にのみ適用され、参加している個々の通話には適用されません。 hConfCall の呼び出し状態は、onHoldPendingConference または onHold である必要があります。

hConsultCall

電話会議に追加する呼び出しを処理します。アプリケーションは、この呼び出しの所有者である必要があります。この呼び出しは、他の会議の親または任意の会議の参加者にすることはできません。 LINEADDRESSCAPS に示されているデバイス機能によっては、lineSetupConference または linePrepareAddToConference を使用して hConsultCall が必ずしも確立されていない場合があります。 hConsultCall の呼び出し状態は、接続、onHold、続行、またはリングバックである必要があります。多くの PBX では、実際に応答する前に電話会議に通話を追加できます。

戻り値

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

LINEERR_CONFERENCEFULL、LINEERR_NOTOWNER、LINEERR_INVALCONFCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注釈

LINEERR_INVALCALLHANDLEが返された場合、追加された呼び出しの指定された呼び出しハンドルは無効です。 hConsultCall は、別の会議の親であるか、既に会議に参加しています。 hConsultCall は他の理由で追加できません ( lineSetupConference または linePrepareAddToConference を使用して確立されている必要がある場合など)。または hConsultCall と hConfCall は、異なる開いている行での呼び出しです。

追加されたパーティの通話ハンドルは、電話会議に通話を追加した後も有効なままです。通常、その状態は会議に変わりますが、電話会議の状態は通常 接続されます。 lineGetConfRelatedCalls を使用すると、指定した通話と同じ電話会議に含まれる通話ハンドルの一覧を取得できます。指定された通話は、電話会議または電話会議の参加者呼び出しです。アプリケーションにハンドルがない呼び出しに対して新しいハンドルが生成され、アプリケーションにはそれらの呼び出しに対するモニター特権が付与されます。個々の参加している通話へのハンドルは、後で lineRemoveFromConference を使用して電話会議からそのパーティーを削除するために使用できます。

lineAddToConference の直後に lineGetConfRelatedCalls が呼び出された場合、TAPI は、呼び出しが実際に会議の一部であると見なす前に、呼び出しがLINECALLSTATE_CONFERENCEDに入ったことを示すLINE_CALLSTATE メッセージの受信を待機するため、関連する呼び出しの完全な一覧を返さない場合があります (つまり、会議の状態はサービスプロバイダーによって確認されます)。アプリケーションが LINE_CALLSTATE メッセージを受信すると、 lineGetConfRelatedCalls は完全な情報を返します。

メモ会議の一部であるすべての呼び出しは、同じオープン回線に存在する必要があります。

会議に参加している通話の通話状態は独立していません。たとえば、電話会議を削除すると、参加しているすべての通話が自動的にアイドル状態になる可能性があります。アプリケーションは、回線のデバイス機能を調べて、使用できる会議の削除の形式を決定する必要があります。アプリケーションは、LINE_CALLSTATEメッセージを追跡して、関連する呼び出しに何が起こったかを判断する必要があります。

電話会議は、 lineSetupConference または lineCompleteTransfer によって確立されます。会議に追加される呼び出しは、通常、 lineSetupConference または linePrepareAddToConference を使用して確立されます。一部のスイッチでは、会議に任意の呼び出しを追加できます。このような呼び出しは、lineMakeCall を使用して設定し、(ハード) 保留にすることができます。アプリケーションは、LINEADDRESSCAPS 構造体の dwAddrCapFlags メンバーを調べて、許可される操作を決定できます。