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

2.17.5 CosTransactions::Current::get_status

名前

　CosTransactions::Current::get_status

形式

　#include  "orb_cplus.h"
　#include  "CosTransactions_cplus.h"
　CosTransactions::Status  CosTransactions::Current::get_status(
　                                 CORBA::Environment&      env);

機能説明

　トランザクションの状態を返します。
CurrentインタフェースのオブジェクトリファレンスはCORBA::ORB::resolve_initial_referencesメソッド(CORBA::ORB::ObjectId_TransactionCurrent)で取得します。

パラメタ

　env

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

復帰値

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

CosTransactions::StatusActive：
  トランザクションを実行中です。
CosTransactions::StatusMarkedRollback：
  rollbackにマークされています。
CosTransactions::StatusPrepared：
  prepareされています。
CosTransactions::StatusCommited：
  commitされました。
CosTransactions::StatusRolledBack：
  rollbackされました。
CosTransactions::StatusUnknown：
  トランザクションの状態が不明です。
CosTransactions::StatusNoTransaction：
  トランザクションを実行中でありません。
CosTransactions::StatusPreparing：
  prepare処理の実行中です。
CosTransactions::StatusCommitting：
  commit処理の実行中です。
CosTransactions::StatusRollingBack：
  rollback処理の実行中です。

　異常終了した場合は、envのexceptionメンバにSystemExceptionオブジェクトのオブジェクトリファレンスが設定されます。以下の例外クラスが通知されます。

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