Joint Client/Servers

CORBA Programming Reference

restart_persistent_systemid

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 restart_persistent_systemid( 
                in PortableServer::Servant   servant, 
                in CORBA::RepositoryId       rep_id,
                in string                    stroid) 
    raises (ServantAlreadyActive, ObjectAlreadyActive);

C++ Binding

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

Arguments

servant

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

rep_id

The repository ID of the interface.

stroid

The stringified version of the ObjectId provided by the user to be set in the object reference being created. It must have been returned from a previous call on start_persistent_systemid.

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.

ObjectAlreadyActive

The stringified ObjectId is already being used for a callback. A given ObjectId can have only one servant associated with it. If you wish to change to a different servant, you must first invoke stop_object with the servant currently in use.

CORBA::BAD_PARAM

The repository ID was a NULL string or the servant was a NULL pointer or the ObjectId supplied was not previously assigned by the system.

CORBA::IMP_LIMIT

In addition to other system reasons for this exception, a reason unique to this situation is that the joint client/server was not initialized with a port number; therefore, a persistent object reference cannot be created.

Description

This operation performs the following actions:

Activates an object using the Servant supplied to service objects of the type rep_id, using the supplied stroid (a stringified ObjectId), which must have been obtained by a previous call on start_persistent_systemid.
Sets the ORB and the POA into the state in which they will accept requests on that object.
Returns an object reference to the object activated.
The reactivation would be done using the restart_persistent_systemid method.

Return Value

CORBA::Object_ptr

An object reference created with the stringified ObjectId stroid 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 done.