ITransactionContextEx

トランザクションを開始する汎用的なトランザクショナルオブジェクトの基本的なメソッドを提供します。このインターフェイスのメソッドを呼び出すことで、複数の COM+ オブジェクトの処理を単一のトランザクションにまとめ、そのトランザクションを明示的にコミットまたはアボートできます。

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

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

hr = CoCreateInstance(
       CLSID_TransactionContextEx, 
       NULL, 
       CLSCTX_INPROC,
       IID_ITransactionContextEx, 
       (void**)&m_pTransactionContext);

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

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

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

Examples

ITransactionContextEx* pTransactionContext = NULL;
IMyObject* pMyObject = NULL;
HRESULT hr;

// Get TransactionContextEx.
hr = CoCreateInstance(CLSID_TransactionContextEx, 
  NULL, CLSCTX_INPROC, IID_ITransactionContextEx, 
  (void**)&pTransactionContext);
if (FAILED(hr)) throw(hr);

// Create an instance of MyObject.
hr = pTransactionContext->CreateInstance(CLSID_CMyObject, 
  IID_IMyObject, (void**)&pMyObject);
if (FAILED(hr)) throw(hr);

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

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

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

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

Examples

ITransactionContextEx::Abort の例を参照してください。

現在のトランザクションに参加しているすべての COM オブジェクトの処理をアボートします。トランザクションはこのメソッドから戻る時点で終了します。(ITransactionContextEx.Abort)

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

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

Examples

ITransactionContextEx* pTransactionContext = NULL;
IMyObject* pMyObject = NULL;
boolean bUserCanceled = FALSE;
HRESULT hr;

// Get TransactionContextEx.
hr = CoCreateInstance(CLSID_ITransactionContextEx, 
  NULL, CLSCTX_INPROC, IID_ITransactionContextEx, 
  (void**)&pTransactionContext);
if (FAILED(hr)) throw(hr);

// Create an instance of MyObject.
hr = pTransactionContext->CreateInstance(CLSID_CMyObject, 
  IID_IMyObject, (void**)&pMyObject);
if (FAILED(hr)) throw(hr);

// Do some work here.

// If something goes wrong, abort the transaction.
if (bUserCanceled) {
    hr = pTransactionContext->Abort();
    if (FAILED(hr)) throw(hr);

// Otherwise, commit it.
} else {
    hr = pTransactionContext->Commit();
    if (FAILED(hr)) throw(hr);
}