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

2.15.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：
  動的メモリの獲得に失敗しました。