ITTAPI::RegisterCallNotifications メソッド (tapi3if.h)

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

RegisterCallNotifications メソッドは、アプリケーションが受信する新しい呼び出し通知を設定します。アプリケーションは、アドレスごとにメソッドを呼び出し、処理できるメディアの種類または種類を示し、要求する特権を指定する必要があります。

発信呼び出しのみを行うアプリケーションは、このメソッドを呼び出す必要はありません。

このメソッドを呼び出す前に、ITTAPIEventNotification 送信インターフェイスを登録する必要があります。

アドレスに対して所有者と監視の両方の特権が必要な場合、このメソッドは fMonitor と fOwner の両方が TRUE に設定された状態で 1 回だけ呼び出す必要があります。

構文

HRESULT RegisterCallNotifications(
  [in]  ITAddress    *pAddress,
  [in]  VARIANT_BOOL fMonitor,
  [in]  VARIANT_BOOL fOwner,
  [in]  long         lMediaTypes,
  [in]  long         lCallbackInstance,
  [out] long         *plRegister
);

パラメーター

[in] pAddress

ITAddress インターフェイスへのポインター。

[in] fMonitor

アプリケーションが呼び出しを監視するかどうかを示すブール値。 VARIANT_TRUEは、アプリケーションが呼び出しを監視することを示します。そうでないことをVARIANT_FALSEします。

[in] fOwner

アプリケーションが着信呼び出しを所有するかどうかを示すブール値。 VARIANT_TRUEは、アプリケーションが着信呼び出しを所有することを示します。VARIANT_FALSEは、そうでないことを示します。

[in] lMediaTypes

アプリケーションで処理できるメディアの種類。

[in] lCallbackInstance

TAPI 3 DLL によって使用されるコールバックインスタンス。 ITTAPIEventNotification 送信インターフェイスの登録時に IConnectionPoint::Advise によって返される gulAdvise 値を指定できます。

[out] plRegister

成功した場合、 ITTAPI::UnregisterNotifications によって使用される戻り値。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	plRegister パラメーターが有効なポインターではありません。
TAPI_E_NOT_INITIALIZED	TAPI オブジェクトが初期化されていません。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。

注釈

このメソッドの複数の呼び出しが 1 つのアドレスで使用されている場合、アプリケーションによって既に監視されている呼び出しが呼び出しハブに渡されると、通話ハブからの参加者呼び出しに関する情報が混乱する可能性があります。

RegisterCallNotifications メソッドは、呼び出しの監視や、指定されたメディアの種類の呼び出しの所有権の受信に関心があるアプリケーションを登録します。これらの呼び出し特権は、 fMonitor パラメーターと fOwner パラメーターで設定されます。アプリケーションでは、複数のメディアの種類を処理する複数のフラグを指定できます。同じアドレスとメディアの種類に複数のアプリケーションが登録されている場合、競合が発生する可能性があります。これらの競合は、ユーザーがアプリケーションに相対的な優先順位を割り当てる優先順位スキームによって解決されます。ユーザーは、 ITTAPI::SetApplicationPriority 関数を呼び出すことによって、アプリケーションの優先順位を設定できます。特定のメディアタイプの優先度が最も高いアプリケーションのみが、そのメディアタイプの呼び出しの所有権(未承諾)を受け取ります。所有権は、着信通話が最初に到着したとき、または通話が引き渡されたときに受信できます。 ITBasicCallControl::HandoffDirect 関数と ITBasicCallControl::HandoffIndirect 関数は、呼び出しの所有権を別のアプリケーションに渡すために呼び出されます。ユーザーがアプリケーションに優先順位を割り当てず、複数のアプリケーションが同じ回線デバイスを開いている場合、既定では、 RegisterCallNotifications を呼び出したアプリケーションの優先度が最も高くなります。