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.
bool
wait_for_completion
true
if the call should block until the shutdown is complete; false
if it should return immediately .
Exception Type | Condition |
---|---|
Ics.CORBA.BAD_INV_ORDER | An error occurs if the current thread is servicing an invocation. |
ORB Interface | ORB Members | Ics Namespace