estrutura FILE_RENAME_INFO (winbase.h)

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

Defina como NULL no caso comum. Se FileName especificar um nome relativo, esse campo poderá ser um identificador para o diretório relativo ao qual o novo nome é resolvido.

FileNameLength

O tamanho do FileName em bytes. Um caractere nulo de terminação não é necessário.

FileName[1]

Uma cadeia de caracteres largos terminada por 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 :.

Requirements

Consulte também

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle