IXATransLookup2::Lookup

 

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 Lookup method is called by the resource manager or the resource manager proxy to get a pointer to the ITransaction interface corresponding to the XA transaction manager's transaction identifier (XID).

The DTC displays the superior XA transaction manager's transaction identifier (XID) in the transaction properties window, which you can access by right-clicking the transaction in the Transaction List window of the Component Services administrative tool. This XID can be used to resolve any in-doubt transactions in the DTC that have an XA transaction manager as a superior.

Syntax

  
HRESULT Lookup( XID * pXIDITransaction ** ppTransaction);  

Parameters

pXID
[in] A pointer to the XA transaction manager's transaction identifier (XID).

ppTransaction
[out] A reference to ITransaction , which is the interface corresponding to the XID.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK
Method completed successfully.

XACT_E_NOTRANSACTION
The XID is not associated with a transaction.

XACT_E_ABORTED
The transaction corresponding to the XID has aborted, possibly due to time-out or unilateral abort.

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