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

2.12.4.3 PortableServer::POAManager::discard_requests()

名前

　PortableServer::POAManager::discard_requests

形式

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

機能説明

　対象のPOAマネージャを「discarding状態」に遷移させます。POAマネージャがdiscarding状態に入ると、関連付けられたPOAは、入ってくるリクエストを破棄します。また、すでにキューに入っており実行されていないリクエストもすべて破棄されます。リクエストが破棄された際には、TRANSIENT例外がクライアントに返されます。

パラメタ

　wait_for_completion

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

復帰値

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

　PortableServer::POAManager::AdapterInactive

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

　CORBA::SystemException

　その他の要因。

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