UseExistingConnection 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 UseExistingConnection property directs BulkCopy object connection behavior.

Syntax

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

Remarks

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

If FALSE (default), the BulkCopyobject specifies an operation implemented using an additional, connection initiated by SQL Distributed Management Objects (SQL-DMO) to the source or target instance of Microsoft SQL Server.

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.

Applies To: