Synopsis

Gets an object reference to the filter currently associated with the subscriber's callback object.

OMG IDL

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

Exceptions

Description

Used when a restartable subscriber wants to unsubscribe. This operation is used in subscriber applications to get an object reference to the filter currently associated with the subscriber's callback object. The FilterID that is passed in must be valid for the subscriber's StructuredProxyPushSupplier object. If the FilterID is not valid for any proxy object associated with the event channel, then a FilterNotFound exception is thrown. The operation is only used by subscribers that shut down and restart.

Restrictions

The following usage restrictions and guidelines apply to this operation:

Return Value

Returns a filter object reference to the filter currently associated with the subscriber's callback object.

Examples

C++ code example:

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

Java code example: