Condividi tramite


IDtcToXaHelperSinglePipe

 

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 proxy uses the IDtcToXaHelperSinglePipe interface to map between the OLE Transactions protocol and the XA protocol when the XA is being used as the native protocol for distributed transactions. ODBC is an example of a resource manager proxy. The following sections use ODBC as a specific example to facilitate the understanding of what needs to be done in the resource manager proxy to map the OLE Transaction protocol to the XA protocol.

This interface differs from the IDtcToXaHelper interface in that it abstracts away the need to use the IResourceManager interface.

When to Implement

You do not need to implement this interface. It is implemented by the core object of the DTC proxy.

When to Use

Use this interface to map between the OLE Transactions protocol and the XA protocol by using the one-pipe connection model but without explicitly using the IResourceManager interface.

Methods in Vtable Order

IDtcToXaHelperSinglePipe methods Description
XARMCreate ODBC drivers call this method each time they open a new ODBC connection to the database. The information the ODBC driver provides makes it possible for the DTC transaction manager to perform database recovery.
ConvertTridToXID Creates an XID from an ITransaction object.
EnlistWithRM Instructs the DTC proxy to enlist on behalf of the XA resource manager. The IDtcToXAMapper::EnlistResourceManager method must be called for every transaction that the connection is requested to be enlisted in.
ReleaseRMCookie Closes the connection between the resource manager proxy and the DTC transaction manager, thereby signifying that the resource manager proxy has closed its connection to the resource manager.

Remarks

Either call the DtcGetTransactionManagerfunction with an riid of IID_IDtcToXaHelperSinglePipe when initially connecting to the DTC, or call QueryInterface on any interface on the DTC proxy core object with an riid of IID_IdtcToXaHelperSinglePipe.

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 oletx2xa.h

See Also

IDtcToXaHelper
IDtcToXaHelperFactory
IDtcToXaMapper