TIP Interfaces in the DTC API

 

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

Note

The TIP service feature and all related APIs are available for use in the operating systems listed in the Requirements sections of the reference topics for those APIs. They may be altered or unavailable in subsequent versions of the operating system.

The following DTC interfaces are to be used for managing TIP transactions:

Objects in the transaction manager implement the ITipTransaction and ITipHelper interfaces, and objects in the application implement the ITipPullSink interface. Specifically, the transaction object in the transaction manager supports the ITipTransaction interface, which provides methods to get a transactions TIP transaction URL and to push a transaction from the DTC to another TIP transaction manager. The format of the TIP transaction URL is as described in the TIP specification.

The core transaction manager object of the transaction manager supports the ITipHelper interface. The ITipHelper interface provides methods to pull transactions from a TIP transaction manager to the DTC and to query the DTCs TIP transaction manager URL. The format of TIP transaction manager URL is as described in the TIP specification.

Note If a version of the DTC does not support TIP, calling IUnknown::QueryInterface for ITipTransaction and ITipHelper fails with the error E_NOINTERFACE.

The ITipPullSink interface is implemented by the application.

See Also

Background for TIP Transactions
TIP Usage Scenarios