CORBA Bootstrapping Programming Reference

CORBA Programming Reference

Tobj_Bootstrap::destroy_current()

Synopsis

Destroys the Current objects for the domain represented by the Bootstrap object.

C++ Mapping

void destroy_current();

Exception

Raises CORBA::NO_PERMISSION if the Bootstrap object is not the owner of the Current objects.

Description

This C++ member function invalidates the Current objects for the domain represented by the Bootstrap object. After invoking the destroy_current() method, the Current objects are marked as invalid. Any subsequent attempt to use the old Current objects will throw the exception CORBA::BAD_INV_ORDER. Good programming practice is to release all Current objects before invoking destroy_current().

Note: The destroy_current() method must be invoked on the Bootstrap object for the domain that currently owns the two Current objects (Transaction and Security). This also results in an implicit invocation to logoff for security and implicitly rolls back any transaction that was begun by the client.

The application must invoke destroy_current() before invoking resolve-_initial_references for TransactionCurrent or SecurityCurrent on another domain; otherwise, resolve_initial_references raises CORBA::NO_PERMISSION.

Return Values

None.

Java Methods

The Java BEA bootstrapping API supports the following methods:

Tobj_Bootstrap
Tobj_Bootstrap.register_callback_port
Tobj_Bootstrap.resolve_initial_references
Tobj_Bootstrap.destroy_current
Tobj_Bootstrap.GetTransactions
Tobj_Bootstrap.getUserTransaction
Tobj_Bootstrap.getNativeProperties
Tobj_Bootstrap.getRemoteProperties

Automation Methods

This section describes the Automation methods supported by the BEA bootstrapping mechanism.