Método CopyRecord (ADO)

Copia uma entidade representada por um registro para outro local.

Sintaxe

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

Parâmetros

de origem
Opcional. Um String valor que contém uma URL especificando a entidade a ser copiada (por exemplo, um arquivo ou diretório). Se de origem for omitido ou especificar uma cadeia de caracteres vazia, o arquivo ou diretório representado pelo de Registro de atual será copiado.

de destino do
Opcional. Um valor String que contém uma URL especificando o local em que de origem será copiado.

UserName
Opcional. Um valor String que contém a ID do usuário que, se necessário, autoriza o acesso ao Destination.

de senha
Opcional. Um valor de cadeia de caracteres de que contém a senha que, se necessário, verifica username.

opções de
Opcional. Um valor CopyRecordOptionsEnum que tem um valor padrão de adCopyUnspecified. Especifica o comportamento desse método.

Assíncrona
Opcional. Um valor booliano que, quando True, especifica que essa operação deve ser assíncrona.

Valor retornado

Um valor String que normalmente retorna o valor de Destination. No entanto, o valor exato retornado depende do provedor.

Observações

Os valores de de origem e de destino de não devem ser idênticos; caso contrário, ocorrerá um erro em tempo de execução. Pelo menos um dos nomes de servidor, caminho ou recurso deve ser diferente.

Todos os filhos (por exemplo, subdiretórios) de de origem são copiados recursivamente, a menos que adCopyNonRecursive seja especificado. Em uma operação recursiva, de destino não deve ser um subdiretório de de origem; caso contrário, a operação não será concluída.

Esse método falhará se Destination identificar uma entidade existente (por exemplo, um arquivo ou diretório), a menos que adCopyOverWrite seja especificado.

Importante

Use a opção adCopyOverWrite de forma criteriosa. Por exemplo, especificar essa opção ao copiar um arquivo para um diretório excluirá diretório e o substituirá pelo arquivo.

Nota

As URLs que usam o esquema http invocarão automaticamente o provedor Microsoft OLE DB para publicação na Internet. Para obter mais informações, consulte URLs absolutas e relativas.

Aplica-se a

do objeto de registro (ADO)