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：

動的メモリの獲得に失敗しました。