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

2.24.2.2 CosTransactions::Control::get_coordinator

名前

　CosTransactions::Control::get_coordinator

形式

　#include  "orb_cplus.h"
　#include  "CosTransactions_cplus.h"
　CosTransactions::Coordinator_ptr  CosTransactions::Control::get_coordinator(
                                CORBA::Environment&       env);

機能説明

　トランザクションをコーディネイトするCoordinatorオブジェクトを返します。
　このCoordinatorオブジェクトを使用してサーバアプリケーションでトランザクションの同期をとる運用ができるようになります。

パラメタ

　env

　例外情報を獲得するためにCORBA::Environmentオブジェクトを指定します。

復帰値

　正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
　異常終了した場合は、envのexceptionメンバにSystemExceptionまたはUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。

　ユーザ例外の場合、以下の例外クラスが通知されます。

CosTransactions::Unavailable
Coordinatorオブジェクトを利用できません。

　システム例外の場合、以下の例外クラスが通知されます。

CORBA::StExcep::NO_IMPLEMENT：
　OTSシステムが起動されていません。
CORBA::StExcep::COMM_FAILURE：
　通信異常が発生しました。
CORBA::StExcep::NO_RESOURCES
　資源不足が発生しました。
CORBA::StExcep::NO_MEMORY：
　動的メモリの獲得に失敗しました。
CORBA::StExcep::INTERNAL：
　CORBAサービスで異常が発生しました。