J-Integra® Espresso Programming Documentation (API)

POA.reference_to_servant Method

This operation returns the servant associated with the object reference if the RETAIN policy is set and the object is present in the active object map. If the POA has the USE_DEFAULT_SERVANT policy and a default servant has been registered with the POA, the default servant is returned. If the object reference was not created by this POA, the WrongAdapter exception is raised.

PortableServer.Servant reference_to_servant(
 CORBA.Object obj_ref
);

Parameters

obj_ref
Object reference.

Return Value

Servant associated with the object reference.

Remarks

none

Exceptions

Exception TypeCondition
POAPackage.WrongPolicy An error occurs if neither the RETAIN nor the USE_DEFAULT_SERVANT policy was specified.
POAPackage.ObjectNotActive An error occurs if the RETAIN policy was specified and the object is not in the active object map.
POAPackage.WrongAdapter An error occurs if the the reference does not belong to this POA.

See Also

POA Interface | POA Members | Ics Namespace