ITransactionExport::Export

 

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 is used to marshal a transaction object for export.

If the DTC Network Node and Transaction Internet Protocol (TIP) Transactions settings are enabled and the Network Transactions setting is disabled, TIP is the protocol that is used.

Syntax

  
HRESULT Export(   IUnknown * punkTransaction,  ULONG * pcbTransactionCookie);  

Parameters

punkTransaction
[in] Pointer to the IUnknown interface on the transaction object to be exported.

pcbTransactionCookie
[out] Pointer to the size in bytes of the transaction cookie.

Return Values

S_OK
Success.

E_UNEXPECTED
An unexpected error occurred.

E_INVALIDARG
The value of either punkTransaction or pcbTransactionCookie is NULL.

E_OUTOFMEMORY
Unable to allocate memory.

XACT_E_ALREADYINPROGRESS
An export is already in progress on this export object. Only one export may be done at a time.

E_NOINTERFACE
punkTransaction did not support the ITransaction Interface.

XACT_E_CONNECTION_DOWN
No longer able to communicate with the transaction manager because the connection to the transaction manager failed. This export object is now invalid.

XACT_E_NOTRANSACTION
Unable to retrieve information for the transaction because it was already completed.

XACT_E_LOGFULL
The DTC log is full.

E_FAIL
Failed to connect to the transaction coordinator.

XACT_E_NOTRANSACTION
The transaction aborted because an older version of the DTC proxy attempted to communicate with a remote DTC, with network transactions disabled.

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

ITransactionExportFactory