структура FILE_RENAME_INFO (winbase.h)

  • Статья

Содержит имя целевого объекта, в которое следует переименовать исходный файл. Используйте только при вызове SetFileInformationByHandle.

Синтаксис

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;

Члены

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

Это поле используется, если для параметра FileInformationClassSetFileInformationByHandle задано значение FileRenameInfo. Если это поле имеет значение TRUE и целевой файл существует, целевой файл будет заменен исходным файлом. Если это поле имеет значение FALSE и целевой файл существует, операция вернет ошибку.

DUMMYUNIONNAME.Flags

Это поле используется, если для параметра FileInformationClasssetFileInformationByHandle задано значение FileRenameInfoEx.

ReplaceIfExists

RootDirectory

Для этого поля должно быть задано значение NULL.

FileNameLength

Размер FileName в байтах, не включая NUL-завершение.

FileName[1]

Строка с расширенными символами с NUL, содержащая новый путь к файлу. Он может иметь одно из следующих значений:

  • Абсолютный путь (диск, каталог и имя файла).
  • Путь относительно текущего каталога процесса.
  • Новое имя файлового потока NTFS, начинающегося с :.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть winbase.h (включая Windows.h)
Распространяемые компоненты Windows SDK в Windows Server 2003 и Windows XP.

См. также раздел

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle