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

2.12.3.2 PortableServer::POA::find_POA()

名前

　PortableServer::POA::find_POA

形式

　PortableServer::POA_ptr find_POA()(
                const CORBA::Char*        adapter_name,
                CORBA::Boolean            activate_it,
                CORBA::Environment& = CORBA::Environment() )
                throw( CORBA::Exception );

機能説明

　対象のPOAオブジェクトの、子POAオブジェクトのうち、adapter_nameで指定した名前を持つ子POAオブジェクトを返します。指定した名前を持つ子POAオブジェクトが存在せず、かつactivate_itパラメタがTRUEの場合、対象のPOAオブジェクトのAdapterActivatorが存在すればそれが起動されます。
　AdapterActivatorでは指定した名前を持つ子POAを生成します。これに成功した場合、本メソッドは生成された子POAオブジェクトを返します。
　上記以外の場合、AdapterNonExistent例外が発生します。

パラメタ

　adapter_name

　子POAの名前。

　activate_it

　true：
　指定した子POAの名前が存在しない場合、新しい子POAを活性化します。
　false：
　指定した子POAの名前が存在しない場合何もしません（AdapterNonExistent例外発生）。

復帰値

　正常終了した場合は、adapter_nameで指定した名前を持つ子POAオブジェクトが返されます。
　異常終了した場合は、以下の例外が発生します。

　PortableServer::POA::AdapterNonExistent

　機能説明参照。

　CORBA::SystemException

　その他の要因。

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