s32 mfsHRenameFile(const u8*oldname, const u8* newname)

Arguments

*oldname   File pathname to be changed
*newname New file pathname

Return value

Error

Function

Renames file

Description

This function changes the file name specified by oldname to newname. When a drive name is assigned by newname it must be the same as the drive name assigned by oldname. The directories of oldname and newname need not be the same. If a different directory is specified the file can be moved. However, if file movement and renaming are performed at the same time, the file will be moved after it is renamed. Therefore, if the oldname directory contains the same file name as the new file name, the name cannot be changed.

Main errors

MFS_ERR_NO	Normal termination
MFS_ERR_DEVICE	Device error An error occurred in an internally called Leo function. Since a Leo function error is stored in the variable mfsError, check this variable to perform processing.
MFS_ERR_PROTECT	Write protected The file attribute is write protected, or the volume attribute is write protected, or the parent directory is write protected.
MFS_ERR_NOTFOUND	File not found The file was not found, or the directory was not found.