ITransactionProxy::Promote method (comsvcs.h)

Promotes a non-DTC transaction to a DTC transaction.

Syntax

HRESULT Promote(
  [out] ITransaction **pTransaction
);

Parameters

[out] pTransaction

An implementation of ITransaction that represents the DTC transaction.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and S_OK.

Remarks

Reasons for promoting a non-DTC transaction to a DTC transaction include exporting the transaction and working with a Queued Moniker Recorder.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 with SP1 [desktop apps only]
Target Platform Windows
Header comsvcs.h

See also

ITransactionProxy