lineGetConfRelatedCalls 関数 (tapi.h)

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

lineGetConfRelatedCalls 関数は、指定された呼び出しと同じ電話会議の一部である呼び出しハンドルの一覧を返します。指定された通話は、電話会議または電話会議の参加者呼び出しです。アプリケーションにハンドルがまだない呼び出しに対して新しいハンドルが生成され、アプリケーションにはそれらの呼び出しに対するモニター特権が付与されます。

構文

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

パラメーター

hCall

呼び出しへのハンドル。これは、電話会議または電話会議の参加者呼び出しです。電話会議の親通話の場合、 hCall の呼び出し状態は任意の状態にすることができます。会議参加者の通話の場合は、会議状態である必要があります。

lpCallList

LINECALLLIST 型の可変サイズのデータ構造へのポインター。要求が正常に完了すると、電話会議のすべての呼び出しに対する呼び出しハンドルがこの構造で返されます。リスト内の最初の通話は電話会議で、他の通話は参加者の通話です。アプリケーションには、まだハンドルがない呼び出しに対するモニター特権が付与されます。アプリケーションが既にハンドルを持っているリスト内の呼び出しに対する特権は変更されません。 lineGetConfRelatedCalls を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

メモ構造体のサイズパラメーターが正しくない場合は、データが上書きされる可能性があります。構造体サイズの設定の詳細については、メモリ割り当てに関するトピックを参照してください。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOCONFERENCE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注釈

指定した通話には、電話会議呼び出しハンドルまたは参加者呼び出しのハンドルを指定できます。たとえば、電話会議にまだ追加されていない相談呼び出しは、会議の一部ではありません。返される一覧の最初のエントリは電話会議呼び出しハンドルです。他のハンドルはすべて参加者の呼び出しです。指定された呼び出しは、常にリストで返される呼び出しの 1 つです。アプリケーションがまだ呼び出しハンドルを持っていないリスト内の呼び出しには、モニター特権が割り当てられます。アプリケーションが既にハンドルを持っている呼び出しに対する特権は変更されません。アプリケーションは lineSetCallPrivilege を使用して、呼び出しの特権を変更できます。

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

アプリケーションは、リスト内の各呼び出しに対して lineGetCallInfo と lineGetCallStatus を呼び出して、呼び出しの情報と状態をそれぞれ決定できます。