4.6.1.3. Controlインタフェース

Controlインタフェースは、アプリケーションプログラムが明示的にトランザクションを管理する場合に使用するオブジェクトインタフェースです。Controlインタフェースをサポートしているオブジェクトは、1個の特定のトランザクションと暗黙的に関連付けられます。

CosTransactions::Controlクラスには次のメソッドがあります。

get_terminator Terminatorオブジェクトを取得する
get_coordinator Coordinatorオブジェクトを取得する

   
4.6.1.3.1. get_terminator

名称 get_terminator - Terminatorオブジェクトを取得する
形式 
 #include "CosTransactions.h"

 CosTransactions::Terminator_ptr CosTransactions::Control::get_terminator(
         CORBA::Environment& env = Ob_default_environment()
 );
説明 Controlオブジェクトと関連付けられたTerminatorインタフェースをサポートするオブジェクトを取得します。
ただし、使用しているControlオブジェクトが中継トランザクションのものである場合は、CosTransactions::Unavailable例外がthrowされ、Terminatorオブジェクトの取得に失敗します。
戻り値 Terminatorオブジェクトのオブジェクトリファレンスを返します。
エラー CORBA標準例外または次の例外がthrowされます。

CosTransactions::Unavailable 使用しているControlオブジェクトは、中継トランザクションのものです。
関連項目 ありません。

   
4.6.1.3.2. get_coordinator

名称 get_coordinator - Coordinatorオブジェクトを取得する
形式 
 #include "CosTransactions.h"

 CosTransactions::Coordinator_ptr CosTransactions::Control::get_coordinator(
         CORBA::Environment& env = Ob_default_environment()
 );
説明 Controlオブジェクトと関連付けられたCoordinatorインタフェースをサポートするオブジェクトを取得します。
このメソッドでは、使用するControlオブジェクトが中継トランザクションの場合であっても正常に終了します。CosTransactions::Unavailable例外はthrowされません。
戻り値 Coordinatorオブジェクトのオブジェクトリファレンスを返します。
エラー CORBA標準例外がthrowされます。
関連項目 ありません。