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
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. |