• Article

UseDestTransaction Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

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

Syntax

object
.UseDestTransaction [= value]

Parts

  • object
    An 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

If 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.

If 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 UseDestTransactionon an instance of Microsoft SQL Server version 7.0, the operation is ignored.

Applies To:

Transfer2 Object