IDtcToXaMapper

 

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

Resource manager proxies can use the IDtcToXaMapper interface to map between OLE Transactions and XA protocol when the XA is being used as the native protocol for distributed transactions. ODBC is an example of an RM 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 OLE Transaction to the XA protocol.

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

Use this interface to map between OLE Transactions and XA protocol using the two-pipe connection model.

IDtcToXaMapper methodsDescription
RequestNewResourceManagerObtains a RM cookie which is stored in the connection object.
TranslateTridToXidCreates an XID from an ITransaction object.
EnlistResourceManagerInstructs the DTC Proxy to enlist on behalf of the XA resource manager.
ReleaseResourceManagerInstructs the DTC Proxy to release an RM cookie that was obtained from the call to RequestNewResourceManager

Either call the DtcGetTransactionManager function with a riid of IID_IDtcToXaMapper when initially connecting to DTC or call QueryInterface on any interface on the DTC proxy core object with a riid of IID_IDtcToXaMapper

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

IDtcToXaHelperFactory
IDtcToXaHelper
IDtcToXaHelperSinglePipe

Show: