ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)

1.13.8 CosTransactions_Current_get_control

名前

  CosTransactions_Current_get_control

形式

  #include  "orb.h"
  #include  "CosTransactions.h"
  CosTransactions_control CosTransactions_Current_get_control(
                                CosTransactions_Current current,
                                CORBA_Environment       *env);

機能説明

  トランザクションコンテキストを管理するControlオブジェクトを返します。
このControlオブジェクトを使用してサーバアプリケーションでトランザクションを完了することもできます。

パラメタ

  current

  CORBA_ORB_resolve_initial_referencesメソッド (CORBA_ORB_ObjectId_TransactionCurrent)で取得したCurrentインタフェースのオブジェクトリファレンスを指定します。

  *env

  例外情報を獲得するためにCORBA_Environment構造体を参照するポインタを指定します。

復帰値

  正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定され、復帰値にトランザクションを識別するための文字列を返します。トランザクションが作成されていない場合は、NULL文字を返します。異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

  システム例外の場合、以下の詳細情報が設定されます。
ex_CORBA_StExcep_NO_RESOURCES:
  資源不足が発生しました。
ex_CORBA_StExcep_NO_MEMORY:
  動的メモリの獲得に失敗しました。
ex_CORBA_StExcep_INTERNAL:
  CORBAサービスで異常が発生しました。