FS_RenameDirectory

Syntax


#include <nitro/fs.h>

BOOL FS_RenameDirectory(const char *src, const char *dst);

Arguments

src	Path name of the directory before the change.
dst	Path name of the directory after the change.

Return Values

Returns TRUE if the directory name was changed properly; returns FALSE otherwise. In case of failure, the error details can be obtained using FS_GetArchiveResultCode().

Description

Changes the specified directory name. This is the same as moving a directory. The function returns FALSE in the following situations:

If the target archive does not support renaming directories
If the directory to be renamed does not exist
If a directory with the same name as the requested new name already exists

Note

This function cannot be called from the interrupt handler (IRQ mode). Also note that in some cases processing may not end if interrupts are left prohibited.

Revision History

2007/09/18 Initial version.

CONFIDENTIAL