J-Integra® Espresso Programming Documentation (API)

ORB.shutdown Method

Instructs the ORB to shut down, which causes all object adapters to shut down, in preparation for destruction.

If the wait_for_completion parameter is true, this operation blocks until all ORB processing (including processing of currently executing requests, object deactivation, and other object adapter operations) has completed.
If the wait_for_completion parameter is FALSE , then shutdown may not have completed upon return.

While the ORB is in the process of shutting down, the ORB operates as normal, servicing incoming and outgoing requests until all requests have been completed. Once an ORB has shutdown, only object reference management operations may be invoked on the ORB or any object reference obtained from it. An application may also invoke the destroy operation on the ORB itself. Invoking any other operation will throw the BAD_INV_ORDER system exception.

The ORB.run method will return after shutdown has been called.

void shutdown(
 bool wait_for_completion
);

Parameters

wait_for_completion
true if the call should block until the shutdown is complete; false if it should return immediately .

Return Value

none

Remarks

none

Exceptions

Exception TypeCondition
Ics.CORBA.BAD_INV_ORDER An error occurs if the current thread is servicing an invocation.

See Also

ORB Interface | ORB Members | Ics Namespace