名前
PortableServer::POAManager::activate
形式
void activate(
CORBA::Environment& = CORBA::Environment() )
throw( CORBA::Exception );機能説明
対象のPOAマネージャを「active状態」に遷移させます。POAマネージャがactive状態に入ると、関連付けられたPOAはリクエストの処理が可能となります。
復帰値
正常終了した場合は、ありません。
異常終了時、以下の例外が発生します。
対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。
その他の要因。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
注意事項
サーバアプリケーションは当メソッドの発行時点でリクエスト受信のための待機状態となります。
名前
PortableServer::POAManager::hold_requests
形式
void hold_requests(
CORBA::Boolean wait_for_completion,
CORBA::Environment& = CORBA::Environment() )
throw( CORBA::Exception );機能説明
対象のPOAマネージャを「holding状態」に遷移させます。POAマネージャがholding状態に入ると、関連付けられたPOAは入ってくるリクエストをキューに入れます。
パラメタ
true：
対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるか、POAマネージャの状態がholding以外に変更されるまで、本メソッドは復帰しません。
false：
POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。
復帰値
正常終了した場合は、ありません。
異常終了した場合は、以下の例外が発生します。
対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。
その他の要因。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
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例外がクライアントに返されます。
パラメタ
true：
対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるか、POAマネージャの状態がdiscarding以外に変更されるまで、本メソッドは復帰しません。
false：
POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。
復帰値
正常終了した場合は、ありません。
異常終了した場合は、以下の例外が発生します。
対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。
その他の要因。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
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は、新しいリクエストとまだ実行されていないリクエストを拒否します。
パラメタ
true：
対象のPOAマネージャに関連付けられたPOAに、RETAINポリシおよびUSER_SERVANT_MANAGERポリシを持つものがある場合、それらのPOAに関連付けられたServantManagerはアクティブなオブジェクトに対し、PortableServer::ServantActivator::etherealize()オペレーションを実行します。
false：
上記のetherealize()オペレーションの実行は行われません。
true：
対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるまで、当メソッドは復帰しません。
false：
POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。
復帰値
正常終了した場合は、ありません。
異常終了した場合は、以下の例外が発生します。
対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。
その他の要因。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
PortableServer::POAManager::get_state
形式
PortableServer::POAManager::State deactivate(
CORBA::Environment& = CORBA::Environment() )
throw( CORBA::Exception );機能説明
対象のPOAマネージャのstatusを取得します。
復帰値
正常終了した場合は、以下のいずれかの値（Stateオブジェクト）が返されます。
PortableServer::POAManager::HOLDING PortableServer::POAManager::ACTIVE PortableServer::POAManager::DISCARDING PortableServer::POAManager::INACTIVE
異常終了した場合は、以下の例外が発生します。
CORBA::SystemException
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。