Joint Client/Servers

CORBA Programming Reference

start_transient

Synopsis

Activates an object, sets the ORB and the POA to the proper state, and returns an object reference to the activated object.

IDL

Object start_transient( in PortableServer::Servant   servant, 
                        in CORBA::RepositoryId       rep_id) 
          raises ( ServantAlreadyActive );

C++ Binding

CORBA::Object_ptr start_transient( 
                    PortableServer::Servant         servant, 
                    const char*                     rep_id);

Arguments

servant

An instance of the C++ implementation class for the interface.

rep_id

The repository id of the interface.

Exceptions

ServantAlreadyActive

The servant is already being used for a callback. A servant can be used only for a callback with a single ObjectId. To receive callbacks on objects containing different ObjectIds, you must create different servants and activate them separately. The same servant can be reused only if a stop_object operation tells the system to stop using the servant for its original ObjectId.

CORBA::BAD_PARAM

The repository ID was a NULL string or the servant was a NULL pointer.

Description

This operation performs the following actions:

Activates an object using the Servant supplied to service objects of the type rep_id, using an ObjectId generated by the system.
Sets the ORB and the POA into the state in which they will accept requests on that object.
Returns an object reference to the activated object. The returned object reference will be valid only until the termination of the client or until the callback servant is halted by the user via the stop_object operation; after that, invocations on that object reference are no longer valid and can never be made valid.

Return Value

CORBA::Object_ptr

A reference to the object that was created with the ObjectId generated by the system and the rep_id provided by the user. The object reference will need to be converted to a specific object type by invoking the _narrow() operation defined for the specific object. The caller is responsible for releasing the object when the conversion is done.