Copies a copy source file to a copy destination file. If the specified copy destination file already exists, it is overwritten.

bool AIT_FileCopy  (
  string strSourceFileName,     // Copy source filename
  string strTargetFileName      // Copy destination filename
);

strSourceFileName (input)

Specify a copy source filename. You can also use a wildcard (*).

strTargetFileName (input)

Specify a copy destination file or directory name. You cannot use the wild card. If the specified copy destination directory does not exist, it is created.

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError may return.

Extended error number	Error code
2	ERROR_FILE_NOT_FOUND
3	ERROR_PATH_NOT_FOUND
5	ERROR_ACCESS_DENIED
87	ERROR_INVALID_PARAMETER
117	ERROR_INVALID_CATEGORY