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
- IUnknown methods
| 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