Condividi tramite


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

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

See Also

ITipTransaction
ITipPullSink