TransactionInterop.GetExportCookie(Transaction, Byte[]) Method

Definition

Transforms a transaction object into an export transaction cookie.

public:
 static cli::array <System::Byte> ^ GetExportCookie(System::Transactions::Transaction ^ transaction, cli::array <System::Byte> ^ whereabouts);
public static byte[] GetExportCookie (System.Transactions.Transaction transaction, byte[] whereabouts);
static member GetExportCookie : System.Transactions.Transaction * byte[] -> byte[]
Public Shared Function GetExportCookie (transaction As Transaction, whereabouts As Byte()) As Byte()

Parameters

transaction
Transaction

The Transaction object to be marshaled.

whereabouts
Byte[]

An address that describes the location of the destination transaction manager. This permits two transaction managers to communicate with one another and thereby propagate a transaction from one system to the other.

Returns

Byte[]

An export transaction cookie representing the specified Transaction object.

Remarks

Call this method if you want to export a transaction. The transaction that is passed along is marshaled into a transaction cookie. You can then send the transaction cookie to the destination process. This is referred to as propagating the transaction between processes or systems. The propagation is considered to be a push model where the local transaction is pushed to the destination. Therefore, information contained in whereabouts must describe the destination transaction manager.

For more information on different propagation models, see the Remarks section of the TransactionInterop class.

Applies to