CosEventComm::PullSupplier Interface Reference

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

import "CosEventComm.idl";

Inheritance diagram for CosEventComm::PullSupplier:

List of all members.

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

---

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::Disconnected

if 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_event

Set 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::Disconnected

if the object considers itself no longer connected to its peer.

---

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

• CosEventComm.idl