ITransactionImportWhereabouts

 

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

ITransactionImportWhereabouts interface is used when propagating transactions from one process to another or one system to another. The resource manager uses this interface to retrieve an opaque address called the whereabouts from its transaction manager. The whereabouts describes the location of the transaction manager. The resource manager sends the whereabouts to the RM proxy. The RM proxy sends the whereabouts to its transaction manager. The whereabouts lets the transaction manager on the RM proxy's system to locate the transaction manager on the resource manager's system. This permits the two transaction managers to communicate with one another and thereby propagate a transaction from one system to the other.

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 retrieve an opaque address called the whereabouts from its transaction manager.

Methods in Vtable Order

ITransactionImportWhereabouts methods Description
GetWhereaboutsSize Returns the length in bytes of the whereabouts of the local transaction manager.
GetWhereabouts Returns the whereabouts of the local transaction manager.

Remarks

You can either call the DtcGetTransactionManager function with a riid of IID_ITransactionImportWhereabouts when initially connecting to DTC or Call QueryInterface on any interface on the DTC proxy core object with a riid of IID_ITransactionImportWhereabouts.

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

See Also

ITransactionImport