Condividi tramite


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

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.

See Also

DtcGetTransactionManager
DtcGetTransactionManagerEx