概要

サブスクライバのコールバック・オブジェクトに現在関連付けられているフィルタのオブジェクト・リファレンスを取得します。

OMG IDL

Filter get_filter( in FilterID filter )
      raises ( FilterNotFound);

例外

説明

再起動可能なサブスクライバでアンサブスクライブする必要があるときに使用します。このオペレーションは、サブスクライバのコールバック・オブジェクトと現在関連付けられているフィルタのオブジェクト・リファレンスを取得するためにサブスクライバ・アプリケーションで使用されます。渡される FilterID は、サブスクライバの StructuredProxyPushSupplier オブジェクトで有効でなければなりません。FilterID がイベント・チャネルと関連付けられているプロキシ・オブジェクトで有効ではない場合は、FilterNotFound 例外がスローされます。このオペレーションは、シャットダウンして再起動されるサブスクライバでのみ使用されます。

制限事項

このオペレーションでは、次の制限とガイドラインが適用されます。

戻り値

サブスクライバのコールバック・オブジェクトに現在関連付けられているフィルタのオブジェクト・リファレンスが返されます。

例

C++ コード例

CosNotify::Filter_var filter = 
     subscription->get_filter( filter_id() );

Java コード例