# CopyFile

int CopyFile (char sourceFileName[], char targetFileName[]);

## Purpose

Copies the contents of an existing file or group of files to another file or group of files.

If the target file is a directory, CopyFile copies the existing file or group of files into the directory.

| Note Windows SDK also contains a CopyFile function. If you include windows.h and do not include utility.h, you will receive compile errors if you call the CopyFile function.

## Parameters

Input
Name | Type | Description
sourceFileName | string | The pathname of the existing file to copy. sourceFileName can contain the wildcard characters '?' and '*,' in which case CopyFile copies all matching files. If you specify an empty string "", CopyFile copies the file found by the most recent call to GetFirstFile or GetNextFile.
targetFileName | string | The pathname of the target file. targetFileName can contain wildcard characters "?" and "*," in which case CopyFile matches this parameter to sourceFileName. If the target file is a directory, CopyFile copies the existing file or group of files into the directory.

## Return Value

Name | Type | Description
result | integer | The result of the call.
Code | Description
0 | Success.
-1 | File not found or directory in path not found.
-3 | General I/O error occurred.
-4 | Insufficient memory to complete operation.
-5 | Invalid path for either of the file names, or source and target file names refer to the same file.
-6 | Access denied.
-7 | Specified path is a directory, not a file.
-8 | Disk is full.