TAO_CosEvent  2.2.1
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Public Member Functions | List of all members
CosEventComm::PullSupplier Interface Reference

Define the interface implemented by pull-style suppliers. More...

import "CosEventComm.idl";

Inheritance diagram for CosEventComm::PullSupplier:
Inheritance graph
Collaboration diagram for CosEventComm::PullSupplier:
Collaboration graph

Public Member Functions

any pull () raises (Disconnected)
 Pull (blocking) one event from the supplier. More...
 
any try_pull (out boolean has_event) raises (Disconnected)
 Pull (non-blocking) one event from the supplier. More...
 
void disconnect_pull_supplier ()
 The peer has disconnected from the pull-style supplier. More...
 

Detailed Description

Define the interface implemented by pull-style suppliers.

A pull-style supplier passively generates events for the Event Service

Member Function Documentation

void CosEventComm::PullSupplier::disconnect_pull_supplier ( )

The peer has disconnected from the pull-style supplier.

The disconnect_pull_supplier operation indicates that the peer has disconnected, for example, because it has been destroyed. The application can safe release all resource attached to this supplier and destroy it, the peer should not make any attempts to pull more data after this request.

any CosEventComm::PullSupplier::pull ( ) raises (Disconnected)

Pull (blocking) one event from the supplier.

The pull operation should block until the next event becomes available.

Returns
The next event
Exceptions
CosEventComm::Disconnectedif the object considers itself no longer connected to its peer.
any CosEventComm::PullSupplier::try_pull ( out boolean  has_event) raises (Disconnected)

Pull (non-blocking) one event from the supplier.

The try_pull operation does not block: if the event data is available, it returns the event data and sets the has_event parameter to true; if the event is not available, it sets the has_event parameter to false and the event data is returned as long with an undefined value.

Parameters
has_eventSet to TRUE if there was another event available, FALSE otherwise.
Returns
The next event if one was available, an any containing a 'long' with an undefined value otherwise.
Exceptions
CosEventComm::Disconnectedif the object considers itself no longer connected to its peer.

The documentation for this interface was generated from the following file: