Renomear método da classe CIM_DataFile

O método Rename renomeia o arquivo lógico (ou diretório) especificado no caminho do objeto. Não há suporte para uma renomeação se o destino estiver em outra unidade ou se for necessário substituir um arquivo lógico existente. Esse método é herdado de CIM_LogicalFile.

Importante

As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão cim 2.x.

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 Rename(
  [in] string FileName
);

Parâmetros

FileName [in]

Novo nome totalmente qualificado do arquivo (ou diretório).

Exemplo: "c:\temp\newfile.txt"

Valor retornado

Retorna um valor de 0 em caso de êxito e qualquer outro número para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

0

Êxito.

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

O método Rename no CIM_DataFile é implementado pelo WMI.

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

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

CIM_DataFile

CIM_DataFile

Tarefas do WMI: arquivos e pastas

Constantes de direitos de acesso de arquivo e diretório