ITmNodeName
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.
When to Implement
You do not need to implement this interface. It is implemented by the transaction object of the DTC proxy.
When to Use
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.
Methods in Vtable Order
- IUnknown methods
| ITmNodeName methods | Description |
|---|---|
| GetNodeNameSize | Gets the length, in bytes, of the node name that will be returned by GetNodeName. |
| GetNodeName | Gets the node name that specifies the location of the transaction manager used by the DTC proxy. |
Remarks
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".
Requirements
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.