ITransactionExportFactory::Create

 

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 creates an export object.

Syntax

  
HRESULT Create(   ULONG cbWhereabouts,  byte * rgbWhereabouts,  ITransactionExport ** ppExport);  

Parameters

cbWhereabouts
[in] The size in bytes of rgbWhereabouts.

rgbWhereabouts
[in] Pointer to the whereabouts.

ppExport
[out] Pointer to the pointer to the ITransactionExport interface on the export object. The export object represents the connection between the caller of ITransactionExportFactory::Create and the destination process which provided the whereabouts. The caller uses the export object returned by this method to marshal a transaction object for export to the destination process.

Return Values

S_OK
Success.

E_FAIL
The data in rgbWhereabouts is corrupted.

E_INVALIDARG
The value of either rgbWhereabouts or ppExport is NULL.

E_OUTOFMEMORY
Unable to allocate memory.

XACT_E_TMNOTAVAILABLE
Unable to connect to the transaction manager, or the transaction manager is unavailable.

XACT_E_CONNECTION_DOWN
No longer able to communicate with the transaction manager because the connection to the transaction manager failed.

XACT_E_CONNECTION_DENIED
The transaction manager refused to accept a connection.

XACT_E_NETWORK_TX_DISABLED
The whereabouts is from a remote node, but Network Transactions is disabled.

XACT_E_PARTNER_NETWORK_TX_DISABLED
The whereabouts is from a remote node and the DTC proxy is the latest version, but network transactions have been 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

ITransactionImport