CORBA Notification Service API Reference

Using the CORBA Notification Service

Channel::push_structured_event

CORBA IDL

void push_structured_event(
      in   CosNotification::StructuredEvent   notification
);

Parameter

notification

This parameter contains the structured event as defined by the CosNotification Service specification.

Exceptions

CORBA_IMP_LIMIT

Indicates one of the following problems with the subscription:

Tobj_Events::POST_UNSUPPORTED_VALUE_IN_ANY

Tobj_Events::POST_UNSUPPORTED_PRIORITY_VALUE

Tobj_Events::POST_DOMAIN_CONTAINS_SEPARATOR

Tobj_Events::POST_TYPE_CONTAINS_SEPARATOR

Tobj_Events::POST_SYSTEM_EVENTS_UNSUPPORTED

Tobj_Events::POST_EMPTY_DOMAIN

Tobj_Events::POST_EMPTY_TYPE

Tobj_Events::POST_DOMAIN_AND_TYPE_TOO_LONG

Note: For more information on exceptions and corresponding minor codes, see "Exception Minor Codes" on page -59.

Description

Used by the poster application to post an event to the Notification Service.

Note: This operation has transactional behavior when used in the context of a transaction. For more information, see the section "Using Transactions" on page -4.

Examples

Note: Code examples shown here are abbreviated. For complete code examples, see "Creating and Posting Events" on page -3.

C++ code example:

channel->push_structured_event(notification);