EnlistDistributedTransaction Method

In This Topic

Enlists in the specified transaction as a distributed transaction.

Syntax

Visual Basic
C#

'Declaration
 
Public Sub EnlistDistributedTransaction( _
   ByVal transaction As ITransaction _
)

public void EnlistDistributedTransaction( 
   ITransaction transaction
)

Parameters

transaction: A reference to an existing transaction in which to enlist.

Remarks

EnlistDistributedTransaction returns an exception if the SqlConnection has already started a transaction using BeginTransaction. However, if the transaction is a local transaction started at the data source (for example, by explicity executing the BEGIN TRANSACTION statement using a SqlCommand object), EnlistDistributedTransaction rolls back the local transaction and enlists in the existing distributed transaction as requested. You will not receive notice that the local transaction was rolled back, and are responsible for managing any local transactions not started using BeginTransaction.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SqlConnection Class
SqlConnection Members

Send Feedback