Condividi tramite


IPrepareInfo2

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

The resource manager uses the IPrepareInfo2 interface to retrieve prepare information from the transaction manager. The resource manager writes this prepare information to its log file when preparing at phase one. The prepare information is needed only if failure recovery is necessary. During recovery, the resource manager identifies the transactions that were prepared but not yet committed or aborted at the time of the failure. The resource manager is in-doubt about the outcome of these transactions. The resource manager provides the prepare information for these in-doubt transactions to the transaction manager. The transaction manager uses the prepare information to locate the in-doubt transactions, determine their outcomes, and return the outcomes to the resource manager. This permits the resource manager to resolve its in-doubt transactions.

When to Implement

You do not need to implement this interface. It is implemented by the enlistment object of the DTC proxy.

When to Use

Use this interface to retrieve prepare information from the transaction manager.

Methods in Vtable Order

IPrepareInfo2 methods Description
GetPrepareInfoSize Determines the size in bytes of the prepare information.
GetPrepareInfo Retrieves the transaction prepare information.

Remarks

Call QueryInterface on the ITransactionEnlistmentAsync interface on the enlistment object with an riid of IID_IPrepareInfo2.

Requirements

For an explanation of the requirement values, see Requirements (Component Services).

Platforms: Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista

Header: Declared in txdtc.h

See Also

ITransactionEnlistmentAsync