CORBA Notification Service API Reference

Using the CORBA Notification Service

CosNotifyComm::StructuredPushConsumer::push_structured_event

Synopsis

Delivers a structured event.

OMG IDL

void push_structured_event(
          in CosNotification::StructuredEvent event)
      raises(CosEventComm::Disconnected);

Exceptions

CosEventComm::Disconnected

The subscriber should never raise this exception.

Description

Used when subscribing. This operation is implemented by the subscriber's callback object and is invoked by the Notification Service each time a structured event is delivered. This operation contains a single input parameter, which is a structured event.

Note: This operation will not be called in a transaction. Also, when this operation is called, it must return quickly because the Notification Service might not start delivering events to other subscribers until this operation returns.

Examples

Note: Code examples shown here are abbreviated. For complete code examples, see "Implementing the CosNotifyComm::StructuredPushConsumer Interface" on page -6.

C++ code example:

virtual void push_structured_event(
      const CosNotification::StructuredEvent& notification );
       {
       // Process the event.
       }