ITransactionImportWhereabouts Interface
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.
Implemented by: | MS DTC proxy |
Object | MS DTC proxy core object |
Interface Source | Either: Call DtcGetTransactionManager with a riid of IID_ITransactionImportWhereabouts when initially connecting to MS DTC or Call QueryInterface on any interface on the MS DTC proxy core object with a riid of IID_ITransactionImportWhereabouts |
Called by: | Resource manager |
interface ITransactionImportWhereabouts : IUnknown
{
HRESULT GetWhereaboutsSize (
[out} ULONG * pcbSize);
HRESULT GetWhereabouts (
[in] ULONG cbWhereabouts,
[out] BYTE * rgbWhereabouts,
[out] ULONG * pcbUsed);
};