Método CopyRecord (ADO)

Copia una entidad representada por un objeto Record a otra ubicación.

Sintaxis

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

Parámetros

Origen
Opcional. Valor String que contiene una dirección URL que especifica la entidad que se va a copiar (por ejemplo, un archivo o directorio). Si Source se omite o especifica una cadena vacía, se copiará el archivo o directorio representado por el objeto Record actual.

Destino
Opcional. Valor de tipo String que contiene una dirección URL que especifica la ubicación donde se copiará Source.

UserName
Opcional. Valor de tipo String que contiene el identificador de usuario que, si es necesario, autoriza el acceso a Destination.

Contraseña
Opcional. Valor de tipo String que contiene la contraseña que, si es necesario, comprueba UserName.

Opciones
Opcional. Valor CopyRecordOptionsEnum que tiene un valor predeterminado de adCopyUnspecified. Especifica el comportamiento de este método.

Async
Opcional. Valor booleano que, cuando es True, especifica que esta operación debe ser asincrónica.

Valor devuelto

Valor de tipo String que normalmente devuelve el valor de Destination. Sin embargo, el valor exacto devuelto depende del proveedor.

Comentarios

Los valores de Source y Destination no deben ser idénticos; de lo contrario, se produce un error en tiempo de ejecución. Al menos uno de los nombres de servidor, ruta de acceso o recurso deben ser diferentes.

Todos los elementos secundarios (por ejemplo, subdirectorios) de Source se copian de forma recursiva, a menos que se especifique adCopyNonRecursive. En una operación recursiva, Destination no debe ser un subdirectorio de Source; de lo contrario, la operación no se completará.

Este método produce un error si Destination identifica una entidad existente (por ejemplo, un archivo o directorio), a menos que se especifique adCopyOverWrite.

Importante

Use la opción adCopyOverWrite con criterio. Por ejemplo, si se especifica esta opción al copiar un archivo a un directorio, se eliminará el directorio y se reemplazará por el archivo.

Nota

Las URL que usan el esquema http invocan automáticamente el Proveedor de Microsoft OLE DB para publicaciones en Internet. Para obtener más información, vea Direcciones URL absolutas y relativas.

Se aplica a

Objeto Record (ADO)