ITransactionContext::Commit method (comsvcs.h)

  • Article

Attempts to commit the work of all COM objects participating in the current transaction. The transaction ends on return from this method.

Syntax

HRESULT Commit();

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED, as well as the following values.

Return code Description
S_OK
 The transaction was committed.
E_FAIL
 The TransactionContext object is not running under a COM+ process, possibly indicating a corrupted registry entry for the TransactionContext component.
CONTEXT_E_ABORTED
 The transaction was aborted.

Remarks

Calling Commit attempts to commit a transaction. However, the transaction aborts under the following conditions:

  • If a participating object returns from a method after calling SetAbort.
  • If an object calls DisableCommit and returns without calling EnableCommit or SetComplete.
  • If an error causes the Microsoft Distributed Transaction Coordinator (DTC) to abort.
When the method returns, whether the transaction commits or aborts, the transaction ends.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comsvcs.h

See also

ITransactionContext