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

2.12.3.19 PortableServer::POA::create_reference_with_id()

名前

　PortableServer::POA::create_reference_with_id

形式

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

機能説明

　oidパラメタで指定したオブジェクトIDとintfパラメタで指定したインタフェースリポジトリIDを内包するオブジェクトリファレンスを生成します。

パラメタ

　oid

　生成するオブジェクトリファレンスに組み込むオブジェクトID。

　intf

　生成するオブジェクトリファレンスに組み込むインタフェースリポジトリID。

復帰値

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

　CORBA::StException::BAD_PARAM

　対象となるPOAにSYSTEM_IDポリシが設定されている場合で、指定したoidの値がシステムが生成した値と異なっています。

　CORBA::SystemException

　その他の要因。

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