estrutura FILE_RENAME_INFO (winbase.h)

  • Artigo

Contém o nome de destino para o qual o arquivo de origem deve ser renomeado. Use somente ao chamar SetFileInformationByHandle.

Sintaxe

typedef struct _FILE_RENAME_INFO {
  union {
    BOOLEAN ReplaceIfExists;
    DWORD   Flags;
  } DUMMYUNIONNAME;
  BOOLEAN ReplaceIfExists;
  HANDLE  RootDirectory;
  DWORD   FileNameLength;
  WCHAR   FileName[1];
} FILE_RENAME_INFO, *PFILE_RENAME_INFO;

Membros

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

Esse campo é usado quando o parâmetro FileInformationClass de SetFileInformationByHandle é definido como FileRenameInfo. Se esse campo for TRUE e o arquivo de destino existir, o arquivo de destino será substituído pelo arquivo de origem. Se esse campo for FALSE e o arquivo de destino existir, a operação retornará um erro.

DUMMYUNIONNAME.Flags

Esse campo é usado quando o parâmetro FileInformationClass de SetFileInformationByHandle é definido como FileRenameInfoEx.

ReplaceIfExists

RootDirectory

Esse campo deve ser definido como NULL.

FileNameLength

O tamanho de FileName em bytes, sem incluir a terminação NUL.

FileName[1]

Uma cadeia de caracteres largos terminada em NUL que contém o novo caminho para o arquivo. O valor pode ser um dos seguintes:

  • Um caminho absoluto (unidade, diretório e nome do arquivo).
  • Um caminho relativo ao diretório atual do processo.
  • O novo nome de um fluxo de arquivos NTFS, começando com :.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho winbase.h (inclua Windows.h)
Redistribuível SDK do Windows no Windows Server 2003 e no Windows XP.

Confira também

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle