Name
RenameFSObj -- rename file or directory (V10.0)
Synopsis
int ok = RenameFSObj(STRPTR oldobj, STRPTR newobj, struct hwTagList *tags);
Function
This function must rename the file or directory specified by oldobj to the name specified by newobj. Note that newobj will never contain any path specification but just the new name for the file or directory. RenameFSObj() must return True on success or False on failure.

The tags argument will be set to a tag list that can contain the following tags:

HWRENAMEFSOBJTAG_USERTAGS:
If this is set, pData will point to a struct hwUserTagList containing a list of user tags passed by the Hollywood script. User tags are a way of passing additional information from Hollywood scripts to plugin functions. See User tags for details.

Inputs
oldobj
filesystem object to rename
newobj
new name for the filesystem object
tags
tag list containing further parameters (see above)
Results
ok
True to indicate success, False on failure

Show TOC