ITransactionImportWhereabouts Interface

Platform SDK: Transaction Server

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);
};