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

2.12.3.23 PortableServer::POA::reference_to_id()

名前

　PortableServer::POA::reference_to_id

形式

　PortableServer::ObjectId*  reference_to_id(
                CORBA::Object_ptr         reference,
                CORBA::Environment& = CORBA::Environment() )
                throw( CORBA::Exception );

機能説明

　referenceパラメタで指定したオブジェクトリファレンスが内包しているオブジェクトIDの値を返します。referenceパラメタに指定するオブジェクトリファレンスは、このメソッドが実行されるPOAオブジェクトが生成したオブジェクトリファレンスのみ有効です。

パラメタ

　reference

　目的のオブジェクトIDを内包したオブジェクトリファレンス。

復帰値

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

　PortableServer::POA::WrongAdapter

　オブジェクトリファレンスがこのPOAによって生成できませんでした。

　CORBA::SystemException

　その他の要因。

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