UseDestTransaction Property

SQL-DMO

SQL-DMO

UseDestTransaction Property

The UseDestTransaction property includes all DROP, CREATE SCHEMA, and data copying statements in a transaction during a transfer operation.

Applies To

Transfer2 Object  

Syntax

object.UseDestTransaction [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetUseDestTransaction(LPBOOL pRetVal);

HRESULT SetUseDestTransaction(BOOL NewValue);

Remarks

When UseDestTransaction is set to TRUE, the entire transfer operation (including DROP statements, CREATE SCHEMA statements, and data copying) is included in a transaction. If any of these operations fail, the transaction is rolled back. Statistics are updated after the transaction is committed. The default is FALSE.

When UseDestTransaction is set to TRUE, the application cannot perform these operations within the transaction:

  • Dump the transaction log.

  • Change bcp settings.

  • Update statistics.

  • Script a full-text catalog.

Note  If an application calls UseDestTransaction on an instance of SQL Server version 7.0, the operation is ignored.

See Also

DropDestObjectsFirst Property

CopySchema Property