Synopsis

Returns the proxy push supplier object created using the consumer admin object obtain_notification_push_supplier operation.

OMG IDL

    ProxySupplier get_proxy_supplier (
           in ProxyID proxy_id )
        raises ( ProxyNotFound );

Exceptions

Descriptions

Used when unsubscribing. This operation is used in subscriber applications to return the proxy push supplier object created using the consumer admin object obtain_notification_push_supplier operation. The ProxyID input parameter uniquely identifies the proxy object. Callers should be aware that the proxy object can be destroyed either due to an error in delivering a transient subscription or through an ntsadmin administrative command. When a proxy object is destroyed, the ProxyID associated with it is invalidated. If the ProxyID is invalid, a ProxyNotFound exception is raised. The subscriber must narrow the proxy supplier to CosNotifyChannelAdmin::StructuredProxyPushSupplier.

Return Value

Returns the object reference for the existing proxy.

Examples

C++ code example:

CosNotifyChannelAdmin::ProxySupplier_var generic_proxy =
        m_consumer_admin->get_proxy_supplier(
          m_subscription_info.news_proxy_id()
        );

CosNotifyChannelAdmin::StructuredProxyPushSupplier_var proxy =
      CosNotifyChannelAdmin::StructuredProxyPushSupplier::_narrow(
          generic_proxy.in()
      );

Java code example:

This class is used by event poster applications. The OMG IDL for this class is as follows:

Module CosNotifyChannelAdmin
{
 interface SupplierAdmin : 
        CosNotification::QoSAdmin,
        CosNotifyComm::NotifyPublish,
        CosNotifyFilter::FilterAdmin,
        CosEventChannelAdmin::SupplierAdmin {

     ProxyConsumer obtain_notification_push_consumer (
               in ClientType ctype,
               out ProxyID proxy_id)
        raises ( AdminLimitExceeded );
  }; 
}; //SupplierAdmin