ITmNodeName

 

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 ITmNodeName interface is used to get the node name that specifies the location of the transaction manager used by the Distributed Transaction Coordinator (DTC) proxy.

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

Use this interface when you need to get the node name that specifies the location of the transaction manager used by the Distributed Transaction Coordinator (DTC) proxy.

ITmNodeName methodsDescription
GetNodeNameSizeGets the length, in bytes, of the node name that will be returned by GetNodeName.
GetNodeNameGets the node name that specifies the location of the transaction manager used by the DTC proxy.

When you call DtcGetTransactionManager or DtcGetTransactionManagerEx, you can optionally specify a node name that indicates the location of the transaction manager used by the DTC proxy. Once the proxy is initialized to use a specific transaction manager, it cannot be changed. Use the ITmNodeName interface to get the node name that specifies the location of the transaction manager.

Note that if you call DtcGetTransactionManager or DtcGetTransactionManagerEx with node name "A", and then call DtcGetTransactionManager or DtcGetTransactionManagerEx again with node name "B", the second call will not fail, but the DTC proxy will still be connected only to node name "A".

For an explanation of the requirement values, see Requirements (COM).

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

Library: msdtcprx.dll.

DtcGetTransactionManager
DtcGetTransactionManagerEx

Community Additions

ADD
Show: