ITransactionImportWhereabouts::GetWhereabouts
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
This method returns the whereabouts, (location), of the local transaction manager.
Syntax
HRESULT GetWhereabouts( ULONG cbWhereabouts, byte * rgbWhereabouts, ULONG * pcbUsed);
Parameters
cbWhereabouts
[in] The size in bytes of the rgbWhereabouts buffer.
rgbWhereabouts
[out] Pointer to the caller allocated buffer in which the location is returned.
pcbUsed
[out] Pointer to the size in bytes of the address returned in rgbWhereabouts.
Return Values
S_OK
Success.
E_INVALIDARG
The value of either rgbWhereabouts or pcbUsed is NULL.
Remarks
An MSDTC proxy can only service one ITransactionImportWhereabouts::GetWhereabouts or ITransactionImportWhereabouts::GetWhereaboutsSize call at a time. If multiple clients call these methods concurrently, the calls might fail with XACT_E_ALREADYINPROGRESS. To avoid this, clients should cache the location and size for each transaction manager, or provide their own synchronization to calls to these methods for each transaction manager.
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