Compartilhar via


Método CopyEx da classe Win32_CodecFile

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

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  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Parâmetros

FileName [in]

Nome totalmente qualificado da cópia do arquivo (ou diretório).

Exemplo: c:\temp\newdirectory.

StopFileName [out]

Nome do arquivo ou diretório em que o método CopyEx falhou. Esse parâmetro será nulo se o método for bem-sucedido.

StartFileName [in, opcional]

Nomeia o arquivo ou diretório filho a ser usado como um ponto de partida para CopyEx. O parâmetro StartFileName normalmente é o parâmetro StopFileName que especifica o arquivo ou diretório no qual ocorreu um erro da chamada de método anterior. Se esse parâmetro for NULL, a operação será executada no arquivo ou diretório especificado na chamada ExecMethod .

Recursivo [in, opcional]

Se for true, a alteração de propriedade será aplicada recursivamente a arquivos e diretórios dentro do diretório especificado pela instância de CIM_LogicalFile .

Observação

Para instâncias de arquivo, o parâmetro de entrada Recursiva é ignorado.

Valor retornado

Retorna um valor de 0 (zero) se o arquivo foi copiado com êxito e qualquer outro número para indicar um erro.

0

A solicitação foi bem-sucedida.

2

O acesso foi negado.

8

Ocorreu uma falha não especificada.

9

O nome especificado não era válido.

10

O objeto especificado já existe.

11

O sistema de arquivos não é NTFS.

12

A plataforma não é o Windows.

13

A unidade não é a mesma.

14

O diretório não está vazio.

15

Houve uma violação de compartilhamento.

16

O arquivo inicial especificado não era válido.

17

Um privilégio necessário para a operação não é mantido.

21

Um parâmetro especificado não é válido.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_CodecFile