Interstage Application Server リファレンスマニュアル（API編）

3.15.2.15 org.omg.PortableServer.POA.activate_object()

名前

　org.omg.PortableServer.POA.activate_object

形式

public byte[]
activate_object(org.omg.PortableServer.Servant p_servant)
throws org.omg.PortableServer.POAPackage.ServantAlreadyActive,
      org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

　オブジェクトIDを生成し、さらにそのオブジェクトIDと指定したServantを対象のPOAのアクティブオブジェクトマップ(AOM)に格納します。復帰値としてオブジェクトIDが返されます。対象のPOAには、SYSTEM_IDポリシとRETAINポリシが設定されている必要があります。

パラメタ

　p_servant

　AOMに登録するServantオブジェクト。

復帰値

　正常終了した場合は、登録したServantに対するオブジェクトIDが返されます。
　異常終了した場合は、以下の例外が発生します。

　org.omg.PortableServer.POAPackage.ServantAlreadyActive

　POAにUNIQUE_IDポリシが設定されており、かつ、p_servantパラメタで指定したServantがすでにAOMに存在します。

　org.omg.PortableServer.POAPackage.WrongPolicy

　対象のPOAにSYSTEM_IDポリシとRETAINポリシが設定されていません。

　org.omg.CORBA.SystemException

　その他の要因。

　システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。