TP Framework

CORBA Programming Reference

TP::get_object_reference()

Synopsis

Returns a pointer to the current object.

C++ Binding

static CORBA::Object_ptr  TP::get_object_reference ();

Arguments

None.

Note that if get_object_reference() is invoked from within either Server::initialize() or Server::release(), it is considered to be invoked outside the scope of an application's TP object execution; therefore, the TobjS::NilObject exception is raised.

Exceptions

The following exception can be raised by the get_object_reference() method:

NilObject

Indicates that the method was invoked outside the scope of an application's CORBA object execution. The reason string contains OutOfScope.

Description

This method returns a pointer to the current object. The CORBA::Object_ptr pointer that is returned can be passed to a client.

Return Value

The get_object_reference() method returns a CORBA::Object_ptr for the current object when invoked within the scope of a CORBA object execution. Otherwise, the TobjS::NilObject exception is raised.