Método CopyEx da classe CIM_DeviceFile

O método CopyEx copia o arquivo de dispositivo lógico (ou diretório) especificado no caminho do objeto para o local especificado pelo parâmetro FileName . Não há suporte para uma cópia se a substituição de um arquivo lógico existente for necessária. Esse método é uma versão estendida do método Copy . Esse método é herdado de CIM_LogicalFile.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

uint32 CopyEx(
  [in]  string     FileName,
  [out] string REF StopFileName,
  [in]  string     StartFileName,
  [in]  boolean    Recursive
);

Parâmetros

FileName [in]

Nome totalmente qualificado do arquivo de destino (ou diretório).

Exemplo: "c:\temp\newdirectory"

StopFileName [out]

Cadeia de caracteres que representa o nome do arquivo (ou diretório) em que o método falhou. Esse parâmetro será nulo se o método for bem-sucedido.

StartFileName [in]

Cadeia de caracteres que representa o arquivo filho (ou diretório) a ser usado como ponto de partida para esse método. Normalmente, o parâmetro StartFileName é o parâmetro StopFileName que especifica o arquivo ou diretório no qual ocorreu um erro na chamada do método anterior. Se esse parâmetro for nulo, a operação será executada no arquivo (ou diretório) especificado na chamada ExecMethod .

Recursivo [in]

Se TRUE, o método também será aplicado recursivamente a arquivos e diretórios dentro do diretório especificado pela instância CIM_DeviceFile . Para instâncias de arquivo, esse parâmetro é ignorado.

Valor retornado

Retorna um valor de 0 (zero) em caso de êxito e qualquer outro número para indicar um erro.

0

Sucesso.

2

Acesso negado.

8

Falha não especificada.

9

Objeto inválido.

10

O objeto já existe.

11

Sistema de arquivos não NTFS.

12

Plataforma não Windows.

13

A unidade não é a mesma.

14

O diretório não está vazio.

15

Violação de compartilhamento.

16

Arquivo inicial inválido.

17

Privilégio não mantido.

21

Parâmetro inválido.

Comentários

Atualmente, esse método não é implementado pelo WMI. Para usar esse método, você deve implementá-lo em seu próprio provedor.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

Requisitos

Confira também

CIM_DeviceFile

CIM_DeviceFile