CORBA API

CORBA Programming Reference

PortableServer::POA::reference_to_id

Synopsis

Returns the ObjectId value encapsulated by the specified reference.

C++ Binding

ObjectId reference_to_id(in Object reference);

Argument

reference

Specifies the reference to the object.

Exceptions

WrongAdapter

This exception is raised if the reference was not created by that POA.

Description

This operation returns the ObjectId value encapsulated by the specified reference. This operation is valid only if the reference was created by the POA on which the operation is being performed. The object denoted by the reference does not have to be active for this operation to succeed.

Note: This function is supported only for a joint client/server.

Return Values

Returns the ObjectId value encapsulated by the specified reference.