CORBA API

CORBA Programming Reference

PortableServer::POA::create_id_assignment_policy

Synopsis

Obtains an object with the IdAssignmentPolicy interface so the user can pass the object to the POA::create_POA operation.

C++ Binding

IdAssignmentPolicy_ptr
       PortableServer::POA::create_id_assignment_policy (
              PortableServer::IdAssignmentPolicyValue value)

Argument

value

A value of either PortableServer::USER_ID, indicating ObjectIds are assigned only by the application, or PortableServer::SYSTEM_ID, indicating ObjectIds are assigned only by the system.

Description

The POA::create_id_assignment_policy operation obtains objects with the IdAssignmentPolicy interface. When passed to the POA::create_POA operation, this policy specifies whether ObjectIds in the created POA are generated by the application or by the ORB. The following values can be supplied:

PortableServer::USER_ID—objects created with that POA are assigned ObjectIds only by the application.
PortableServer::SYSTEM_ID—objects created with that POA are assigned ObjectIds only by the POA. If the POA also has the PERSISTENT LifespanPolicy, assigned ObjectIds must be unique across all instantiations of the same POA.

If no IdAssignmentPolicy is specified at POA creation, the default is SYSTEM_ID.

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

Return Values

Returns an Id Assignment policy.