MDAC 2.5 SDK - ADO


 

CopyRecord Method

        Applies To

Copies a file or directory, and its contents, to another location.

Syntax

CopyRecord (Source, Destination, UserName, Password, Options, Async)

Parameters

Source   Optional. A String value that contains a URL specifying the file or directory to be copied. If Source is omitted or specifies an empty string, the file or directory represented by this Record will be copied.

Destination   Optional. A String value that contains a URL specifying the location where Source will be copied.

UserName   Optional. A String value that contains the user ID that, if needed, authorizes access to Destination.

Password   Optional. A String value that contains the password that, if needed, verifies UserName.

Options   Optional. A CopyRecordOptionsEnum value that has a default value of adCopyUnspecified. Specifies the behavior of this method.

Async   Optional. A Boolean value that, when True, specifies that this operation should be asynchronous.

Return Value

A String value that typically returns the value of Destination. However, the exact value returned is provider-dependent.

Remarks

The values of Source and Destination must not be identical; otherwise, a run-time error occurs. At least one of the server, path, or resource names must differ.

All subdirectories of Source are copied recursively, unless adCopyNonRecursive is specified. In a recursive operation, Destination must not be a subdirectory of Source; otherwise, the operation will not complete.

This method fails if Destination identifies an existing file or directory, unless adCopyOverWrite is specified.

Important   Use the adCopyOverWrite option judiciously. For example, specifying this option when copying a file to a directory will delete the directory and replace it with the file.