FILE_RENAME_INFORMATION

2OO1, 17 March

typedef struct _FILE_RENAME_INFORMATION {



  BOOLEAN                 ReplaceIfExists;
  HANDLE                  RootDirectory;
  ULONG                   FileNameLength;
  WCHAR                   FileName[1];

} FILE_RENAME_INFORMATION, *PFILE_RENAME_INFORMATION;

Structure FILE_RENAME_INFORMATION is used as input buffer for function NtSetInformationFile, called with FileRenameInformation information class. Using this structure caller can rename file, or move it into other directory.

ReplaceIfExists If set, and file with the same name as destination exist, it will be replaced. If no, STATUS_OBJECT_NAME_COLLISION is returned.

RootDirectory Optional HANDLE to parent directory for destination file.

FileNameLength Length of FileName array, in bytes.

FileName[1] UNICODE string specifing destination file name. If RootDirectory is NULL, it must contains full system path, or only destination file name for in-place rename operation.

Documented by:

Tomasz Nowak

Bo Branten

Requirements:

Library: ntdll.lib

Undocumented functions of NTDLL