CORBA Notification Service API Reference

Using the CORBA Notification Service

CosNotifyChannelAdmin::ConsumerAdmin::get_proxy_supplier

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

CosNotifyChannelAdmin::ProxyNotFound

Indicates that the ProxyID could not be found.

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()
      );

CosNotifyChannelAdmin::SupplierAdmin Class

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