UseExistingConnection Property

SQL-DMO

SQL-DMO

UseExistingConnection Property

The UseExistingConnection property directs BulkCopy object connection behavior.

Applies To
BulkCopy Object
Syntax

object.UseExistingConnection [= 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 GetUseExistingConnection(LPBOOL pRetVal);

HRESULT SetUseExistingConnection(BOOL NewValue);

Remarks

When TRUE, the BulkCopy object uses an application-initiated connection. The connection used is determined by the Table or View object referenced in the ImportData or ExportData method call.

When FALSE (default), the BulkCopy object specifies an operation implemented using an additional, SQL-DMO-initiated connection to the source or target instance of Microsoft® SQL Server™ 2000.

Note  To perform bulk copy operations using the BulkCopy object, the SQL-DMO application connection to an instance of SQL Server must be enabled. To enable a connection for bulk copy, set the EnableBcp property of the SQLServer object. The UseExistingConnection property of the BulkCopy object does not enable a connection for bulk copy operations.