void FSEntry_Copy (CPU_CHAR *name_full_src,
CPU_CHAR *name_full_dest,
CPU_BOOLEAN excl,
FS_ERR *p_err);
File | Called from | Code enabled by |
---|---|---|
| Application | not |
Copy a file.
Arguments
name_full_src
Name of the source file. See the sub-topic "µC/FS File and Directory Names and Paths" in the topic Useful Information.
name_full_dest
Name of the destination file.
excl
Indicates whether the creation of the new entry shall be exclusive
DEF_YES
, if the entry shall be copied only if name_full_dest
does not exist.
DEF_NO
, if the entry shall be copied even if name_full_dest
does exist.
p_err
Pointer to variable that will the receive return error code from this function:
FS_ERR_NONE
File copied successfully.
FS_ERR_NAME_NULL
Argument name_full_src
or name_full_dest
passed a NULL pointer.
FS_ERR_NAME_INVALID
Entry name specified invalid OR volume could not be found.
FS_ERR_NAME_PATH_TOO_LONG
Entry name specified too long.
FS_ERR_VOL_NOT_OPEN
Volume was not open.
FS_ERR_VOL_NOT_MOUNTED
Volume was not mounted.
FS_ERR_BUF_NONE_AVAIL
Buffer not available.
FS_ERR_DEV
Device access error.
Or entry error (See Entry Error Codes).
Returned Value
None.
Notes/Warnings
name_full_src
must be an existing file. It may not be an existing directory.- If excl is
DEF_NO
,name_full_dest
must either not exist or be an existing file; it may not be an existing directory. If excl isDEF_YES
,name_full_dest
must not exist.