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

2.12.3.25 PortableServer::POA::id_to_reference()

名前

　PortableServer::POA::id_to_reference

形式

　CORBA::Object_ptr id_to_reference(
                const PortableServer::ObjectId&  oid,
                CORBA::Environment& = CORBA::Environment() )
                throw( CORBA::Exception );

機能説明

　oidパラメタで指定したオブジェクトIDの値のオブジェクトが現在アクティブである場合、オブジェクトをアクティブにするために使用する情報を内包したオブジェクトリファレンスを返します。対象のPOAは、RETAINポリシが設定されている必要があります。

パラメタ

　oid

　オブジェクトリファレンスを取得するServantに関連付けられたオブジェクトID。

復帰値

　正常終了した場合は、オブジェクトリファレンスが返されます。
　異常終了した場合は、以下の例外が発生します。

　PortableServer::POA::ObjectNotActive

　対象のPOA内で、指定したオブジェクトIDがアクティブではありません。

　PortableServer::POA::WrongPolicy

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

　CORBA::SystemException

　その他の要因。

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