Page Comparison

...

Returned Value

None.

Notes/Warnings

1. If name_full_old and name_full_new specify entries on different volumes, then name_full_old must specify a file. If name_full_old specifies a directory, an error will be returned.
2. If name_full_old and name_full_new specify the same entry, the volume will not be modified and no error will be returned.
3. If name_full_old specifies a file:
   1. name_full_new must not specify a directory;
   2. if excl is DEF_NO and name_full_new is a file, it will be removed.
4. If name_full_old specifies a directory:
   1. name_full_new must not specify a file
   2. if excl is DEF_NO and name_full_new is a directory, name_full_newmust be empty; if so, it will be removed.
5. If excl is DEF_NO, name_full_new must not exist.
6. The root directory may not be renamed.