Previous

Next

Function RTFRename

RTFRename renames a file:

int RTFRename(const char * FileName, const char * NewName);

Parameters

FileName

Must point to the name of the file to be renamed.

NewName

Points to the new name of the file. Both file names must not contain wildcards and must reference the same logical drive. However, they may reference different directories. Data files and directory files (except root directories) may be renamed or moved with this call.

return value

If the function succeeds, the return value is RTF_NO_ERROR. If the function fails, the return value is a negative error code.

This function fails if a file with the name specified by NewName already exists, on an attempt to rename the current directory or a parent of the current directory, or on an attempt to rename a volume label.

File Name Operations

Function RTFDelete