File - Copy

Copies files from one location to another on the local system.

Action ID:
Action Category:
Action List Syntax:

25
File 
File.Copy (<<SOURCE>>, <<DESTINATION>>)

Settings

Locations

Source:

The path and filename to copy from. You can use the "*" and "?" wildcards in this field.

Destination:

The destination folder and/or file. Do not use wildcards in this field.

NOTE

 

 

 

The destination folder MUST already exist when performing this action or an error will result.

If Destination specifies a path to a file, all of the folders included in the path must already exist.

You can use a "Folder - Create" action to create a destination folder if necessary.

Options

Recurse subfolders

Select this option if you want the copy command to recurse through subfolders when a wildcard is used in the Source field.

Overwrite existing files

Select this option if you want the copied files to overwrite any existing files in the destination folder.

When this option is enabled, the source files will be copied right over the destination files.

When this option is disabled, a source file won't be copied if a file with that name already exists in the destination folder.

Continue copying files even if one or more fail

Select this option if you want the copy operation to continue even if some files fail to copy.

When this option is disabled, the copy operation will stop as soon as the first error occurs.

Copy hidden and system files

Select this option if you want to copy files that have the "hidden" or "system" attributes set.

When this option is disabled, hidden and system files will not be copied.

Dialog

Dialog title:

The text that will be displayed in the title bar when the "Copying files" dialog is displayed.

Error Codes

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Verbose Message
(%LastErrorDetails%)

0 (OK)

 

 

1

MSG_ERR_COPY_FILE

MSG_ERR_COPY_FILE
MSG_ERR_INVALID_SOURCE
<<SOURCE>>

2

MSG_ERR_COPY_FILE

MSG_ERR_COPY_FILE
MSG_ERR_INVALID_DESTINATION
<<DESTINATION>>

3

MSG_ERR_COPY_FILE

MSG_ERR_COPY_FILE
MSG_ERR_FILE_NOT_FOUND
<<SOURCE>>

4

MSG_ERR_COPY_FILE

MSG_ERR_COPY_FILE
MSG_ERR_PATH_NOT_FOUND
<<DESTINATION>>

5

MSG_ERR_COPY_FILE

MSG_ERR_COPY_FILE
MSG_ERR_NOCOPY_ONEORMORE
Operating System Error

Examples

Installing a font