ITransactionContext

複数の COM+ オブジェクトの処理を 1 つのトランザクションにまとめ、そのトランザクションを明示的にコミットまたは中止できるようにします。

トランザクションコンテキストオブジェクトを使用してトランザクションを制御すると、そのトランザクションを駆動するビジネスロジックの再利用が制限されるため、使用は必要最小限にとどめてください。

ITransactionContext インターフェイスへの参照は、次の例のように適切な呼び出しでトランザクションコンテキストオブジェクトを作成することで取得します。

hr = CoCreateInstance(
       CLSID_TransactionContext, 
       NULL, 
       CLSCTX_INPROC,
       IID_ITransactionContext, 
       (void**)&m_pTransactionContext);

トランザクションコンテキストオブジェクトによって開始されたトランザクションのスコープ内で実行できる COM オブジェクトを作成します。(ITransactionContext.CreateInstance)

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことができます。

Microsoft Distributed Transaction Coordinator が実行されておらず、オブジェクトがトランザクション対応である場合、オブジェクトの作成は成功します。ただし、そのオブジェクトに対するメソッド呼び出しは CONTEXT_E_TMNOTAVAILABLE で失敗します。オブジェクトはこの状態から回復できないため、解放する必要があります。

現在のトランザクションに参加しているすべての COM オブジェクトの処理をコミットしようとします。トランザクションはこのメソッドから制御が戻った時点で終了します。(ITransactionContext.Commit)

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および E_UNEXPECTED に加えて、次の値を返すことができます。

Commit を呼び出すと、トランザクションのコミットが試みられます。ただし、次の条件下ではトランザクションは中止されます。

• 参加中のオブジェクトが SetAbort を呼び出した後にメソッドから制御を返した場合。
• オブジェクトが DisableCommit を呼び出し、EnableCommit または SetComplete を呼び出さずに制御を返した場合。
• エラーによって Microsoft Distributed Transaction Coordinator (DTC) が中止した場合。

現在のトランザクションに参加しているすべての COM オブジェクトの処理を中止します。トランザクションはこのメソッドから制御が戻った時点で終了します。(ITransactionContext.Abort)

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および E_UNEXPECTED に加えて、次の値を返すことができます。

Abort を呼び出すと、メソッドから制御が戻った時点でトランザクションが終了し、参加中のすべてのオブジェクトが自動的に非アクティブ化されます。トランザクションに参加している各リソースマネージャーは、それらのオブジェクトに代わって実行された操作をロールバックします。