J-Integra® Espresso Programming Documentation (API)

POA.servant_to_id Method

This operation has the following possibilities:

  1. If the POA has the UNIQUE_ID policy and the specified servant is active, the object id associated with that servant is returned.
  2. If the POA has the IMPLICIT_ACTIVATION policy and either the POA has the MULTIPLE_ID policy or the specified servant is not active, the servant is activated using a POA-generated object id which then is returned.
  3. If the POA has the USE_DEFAULT_SERVANT policy, the servant specified is the default servant, and the operation is being invoked in the context of executing a request on the default servant, then the object id associated with the current invocation is returned.
  4. the ServantNotActive exception is raised.
byte[] servant_to_id(
 PortableServer.Servant servant
);

Parameters

servant
servant for which the object reference needs to be obtained.

Return Value

object id associated with the servant.

Remarks

none

Exceptions

Exception TypeCondition
POAPackage.WrongPolicy An error occurs if the USE_DEFAULT_SERVANT policy or a combination of the RETAIN policy and either the UNIQUE_ID or IMPLICIT_ACTIVATION policies are not present.
POAPackage.ServantNotActive An error occurs if the above specified policies and rules are not met.

See Also

POA Interface | POA Members | Ics Namespace