ITipHelper
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 ITipHelper and the ITipTransaction interfaces provide functionality to propagate transaction objects using the Transaction Internet Protocol (TIP). The ITipHelper interface provides methods to pull transactions given a TIP Transaction URL and to get the TIP TM URL of the local TM.
Note
The TIP service feature is deprecated. 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 might be unavailable in subsequent versions of the operating system. You might consider using the WS-AtomicTransaction (WS-AT) protocol as a replacement transaction coordination and propagation technology. WS-AT support is provided through Windows Communication Foundation (WCF) as part of the .Net Framework. For more information about WS-AT support in the .Net Framework see Transactions.
When to Implement
You do not need to implement this interface. The core TM object in the DTC Proxy implements this interface.
When to Use
Use this interface to pull transactions from a TIP Transaction manager (TM) to an OLE Transaction TM and to query the OLE Transactions TIP TM URL of the TM.
Methods in Vtable Order
- IUnknown methods
| ITipHelper methods | Description |
|---|---|
| Pull | Returns an ITransaction pointer to the transaction object created corresponding to the transaction identified by the TIP Transaction URL pszTxUrl. |
| PullAsync | Provides the option for applications to asynchronously pull a transaction |
| GetLocalTmUrl | Retrieves the TIP TM URL identifying the application's OLE Transaction TM. |
Remarks
To get a pointer to this interface, applications can either call QueryInterface on the core TM object or call DtcGetTransactionManager. Both these calls would use IID_ITipHelper as the IID of the interface to return.
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 txcoord.h