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

3.15.2.20 org.omg.PortableServer.POA.servant_to_id()

名前

　org.omg.PortableServer.POA.servant_to_id

形式

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

機能説明

　対象のPOAに設定するポリシによって、下記(a)(b)の動作を行います。
(a) 対象のPOAがUNIQUE_IDポリシをもち、p_servantパラメタで指定したServantがアクティブな場合は、Servantに関連付けられたオブジェクトIDが返されます。
(b) 対象のPOAがIMPLICIT_ACTIVATIONポリシとMULTIPLE_IDポリシを持つ場合、またはIMPLICIT_ACTIVATIONポリシをもち指定したServantがアクティブでない場合、ServantはPOAが生成するオブジェクトIDと、Servantに関連付けられたインタフェースリポジトリIDを使用してアクティベートされます。そして、対応するオブジェクトIDが返されます。
対象のPOAは、RETAINポリシに加え、UNIQUE_IDポリシまたはIMPLICIT_ACTIVATIONポリシを設定されている必要があります。

パラメタ

　p_servant

　オブジェクトIDを取得する対象のServant（Servant型オブジェクト）。

復帰値

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

　org.omg.PortableServer.POAPackage.ServantNotActive

　上記機能説明の(a)、(b)以外の場合。

　org.omg.PortableServer.POAPackage.WrongPolicy

　対象のPOAにRETAINポリシとUNIQUE_IDポリシまたは、RETAINポリシとIMPLICIT_ACTIVATIONポリシが設定されていません。

　org.omg.CORBA.SystemException

　その他の要因。

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