FSEntry_Copy()

void  FSEntry_Copy (CPU_CHAR     *name_full_src,

                    CPU_CHAR     *name_full_dest,

                    CPU_BOOLEAN   excl,

                    FS_ERR       *p_err);

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 µC/FS 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 is DEF_YES, name_full_dest must not exist.