ITipHelper

 

Updated: July 19, 2016

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.

System_CAPS_ICON_note.jpg 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.

You do not need to implement this interface. The core TM object in the DTC Proxy implements this interface.

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.

ITipHelper methodsDescription
PullReturns an ITransaction pointer to the transaction object created corresponding to the transaction identified by the TIP Transaction URL pszTxUrl.
PullAsyncProvides the option for applications to asynchronously pull a transaction
GetLocalTmUrlRetrieves the TIP TM URL identifying the application's OLE Transaction TM.

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.

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

ITipTransaction
ITipPullSink

Community Additions

ADD
Show: