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

2.12.4.4 PortableServer::POAManager::deactivate()

名前

　PortableServer::POAManager::deactivate

形式

　void deactivate(
                CORBA::Boolean        etherealize_objects,
                CORBA::Boolean        wait_for_completion,
                CORBA::Environment& = CORBA::Environment() )
                throw( CORBA::Exception );

機能説明

　対象のPOAマネージャを「inactive状態」に遷移させます。POAマネージャがinactive状態に入ると、関連付けられたPOAは、新しいリクエストとまだ実行されていないリクエストを拒否します。

パラメタ

　etherealize_objects

　true：
　対象のPOAマネージャに関連付けられたPOAに、RETAINポリシおよびUSER_SERVANT_MANAGERポリシを持つものがある場合、それらのPOAに関連付けられたServantManagerはアクティブなオブジェクトに対し、PortableServer::ServantActivator::etherealize()オペレーションを実行します。
　false：
　上記のetherealize()オペレーションの実行は行われません。

　wait_for_completion

　true：
　対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるまで、当メソッドは復帰しません。
　false：
　POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。

復帰値

　正常終了した場合は、ありません。
　異常終了した場合は、以下の例外が発生します。

　PortableServer::POAManager::AdapterInactive

　対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。

　CORBA::SystemException

　その他の要因。

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