option (ULONG) - input

ULONG bit flags that define how the DosCopy function is done.

Bit

Description
31-3
Reserved. These bits must be set to zero.
2
DCPY_FAILEAS (0x00000004)
Discard the EAs if the source file contains EAs and the destination file system does not support EAs.
• Discard the EAs (extended attributes) if the destination file system does not support EAs.

• Fail the copy if the destination file system does not support EAs.
1
DCPY_APPEND (x00000002)
Append the source file to the target file's end of data.
• Replace the target file with the source file.
  
• Append the source file to the target file's end of data.

  This is ignored when copying a directory, or if the target file does not exist.

0
DCPY_EXISTING (0x00000001)
Existing Target File Disposition.
• Do not copy the source file to the target if the file name already exists within the target directory. If a single file is being copied and the target already exists, an error is returned.

• Copy the source file to the target even if the file name already exists within the target directory.
Bit flag DCPY_FAILEAS can be used in combination with bit flag DCPY_APPEND or DCPY_EXISTING.