Tuxedo
0

Administering a Tuxedo Application at Run Time

 Previous Next Contents View as PDF  

TP::unregister_factory()

Synopsis

Locates the BEA Tuxedo FactoryFinder object and removes a factory.

C++ Binding

static void TP::unregister_factory (
CORBA::Object_ptr factory_or, const char* factory_id);

Arguments

factory_or

Specifies the object reference that was created for an application factory using the TP::create_object_reference() method.

factory_id

Specifies a string identifier that is used to identify the application factory. For some suggestions as to the composition of this string, see Creating CORBA Server Applications.

Exceptions

The following exceptions can be raised by the unregister_factory() method:

CannotProceed

InvalidName

Indicates that the id string is empty. It is also raised if the field contains blank spaces or control characters.

RegistrarNotAvailable

Note: Another possible reason that this exception might occur is that the FactoryFinder cannot participate in a transaction. Therefore, you may need to suspend the current transaction before issuing the TP::register_factory() and TP::unregister_factory() calls. For information on suspending and resuming transactions, see Using CORBA Transactions in the online documentation.

TobjS::OverFlow

Indicates that the id string is longer than 128 bytes (currently the maximum allowable length).

Description

This method locates the BEA Tuxedo FactoryFinder object and removes a factory. Typically TP::unregister_factory() is invoked from Server::release() to unregister server factories.

Return Value

None.

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy