Code Block | ||
---|---|---|
| ||
void FSEntry_Rename (CPU_CHAR *name_full_old, |
...
CPU_CHAR *name_full_new, |
...
CPU_BOOLEAN excl, |
...
FS_ERR *p_err); |
File | Called from | Code enabled by |
---|---|---|
| Application; | not |
...
Indicates whether the creation of the new entry shall be exclusive (see Note #1):
DEF_YES
, if the entry shall be renamed only if name_full_new
does not exist.
...
Returned Value
None.
Notes/Warnings
- If
name_full_old
andname_full_new
specify entries on different volumes, thenname_full_old
must specify a file. Ifname_full_old
specifies a directory, an error will be returned. - If
name_full_old
andname_full_new
specify the same entry, the volume will not be modified and no error will be returned. - If
name_full_old
specifies a file:name_full_new
must not specify a directory;- if excl is
DEF_NO
andname_full_new
is a file, it will be removed.
- If
name_full_old
specifies a directory:name_full_new
must not specify a file- if excl is
DEF_NO
andname_full_new
is a directory,name_full_new
must be empty; if so, it will be removed.
- If excl is
DEF_NO
,name_full_new
must not exist. - The root directory may not be renamed.