Function RTFCompactDir

RTFCompactDir compacts a directory or all directories below a given directory:

int RTFCompactDir(const char * DirName, DWORD Flags);

Parameters

DirName

Name of the directory to compact. No other files on the same drive as the given directory may be open (unless flag RTF_CMPCT_READ_ONLY is specified). Otherwise, RTF_ACCESS_DENIED is returned.

Flags

The Flags parameter specifies further options. Zero or any combination of the following values may be specified:

Value	Meaning
RTF_CMPCT_READ_ONLY	RTFCompactDir should run in read-only mode. It will return the number of directory entries that could be recovered, but no data on disk is actually changed.
RTF_CMPCT_RECURSIVE	RTFCompactDir should compact the specified directory as well as all of its subdirectories, etc. If applied on a root directory, all directories of a logical drive will be compacted.

return value

If the function succeeds, it returns the number of recovered short directory entries, 32 bytes each. If the function fails, the return value is a negative error code.

RTFCompactDir copies all used directory entries to the start of the directory and zeros out all slack space. If the slack space is larger than one cluster, the slack space is freed, reducing the allocated size of a directory. Note that this is the only way a directory can shrink (apart from removing it with RTFRemoveDir).

It is recommended to use RTFCompactDir when a lot of files have been deleted or renamed in a directory to reduce its size.

Left Directories

Function RTFRemoveDir