概要

Sets the filter object on the subscriber’s callback object.

OMG IDL

add_filter(
      in Filter new_filter
);

例外

説明

サブスクライブするときに使用します。このオペレーションは、サブスクライバのコールバック・オブジェクトのフィルタ・オブジェクトを設定するためにサブスクライバ・アプリケーションで使用されます。このオペレーションを使用するアプリケーションがシャットダウンされて再起動される場合は、filter_id を永続ストレージに書き込む必要があります。

注記 このオペレーションは、サブスクライバのコールバック・オブジェクトが接続された後に呼び出すことはできません (上記の connect_structured_push_consumer を参照)。また、複数回呼び出すこともできません。さらに、このオペレーションを呼び出すときには、フィルタの制約式が既にフィルタに存在していなくてはなりません (CosNotifyFilter::Filter add_constraints を参照)。

注記 イベント・チャネルのデフォルト・フィルタ・ファクトリで作成されたフィルタのみ追加することができます。

戻り値

Returns a filter_id.

例

C++ コード例

CosNotifyFilter::FilterID filter_id =
      subscription->add_filter(filter.in());

Java コード例