CORBA API

CORBA Programming Reference

CORBA::Object::_duplicate

Synopsis

Duplicates the Object object reference.

C++ Binding

CORBA::Object_ptr CORBA::Object::_duplicate(
                                 Object_ptr Obj);

Argument

obj

The object reference to be duplicated.

Description

This member function duplicates the specified Object object reference (Obj). If the given object reference is nil, the _duplicate function returns a nil object reference. The object returned by this call should be freed using CORBA::release, or should be assigned to CORBA::Object_var for automatic destruction.

This function can throw CORBA system exceptions.

Return Values

Returns the duplicate object reference. If the specified object reference is nil, a nil object reference is returned.

Example

CORBA::Object_ptr op = TP::create_object_reference(
                            "IDL:Teller:1.0","MyTeller");
CORBA::Object_ptr dop = CORBA::Object::_duplicate(op);