DosCopy
Bindings: C, MASM
This call copies the specified file or subdirectory to the target file or
subdirectory.
DosCopy (SourceName, TargetName, OpMode, Reserved)
SourceName (PSZ) - input
Address of the ASCIIZ path name of the source file, subdirectory, or
character device. Global file name characters are not allowed.
TargetName (PSZ) - input
Address of the ASCIIZ path name of the target file, subdirectory, or
character device. Global file name characters are not allowed.
OpMode (USHORT) - input
Word-length bit map that defines how the DosCopy function is done.
Bit Description
15-2 Reserved and must be set to zero.
1 0 = Replace the target file with the source file.
1 = Append the source file to the target file's end of data.
This is ignored when copying a directory or if the target
file doesn't exist.
0 0 = 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.
1 = Copy the source file to the target even if the file name
already exists within the target directory.
Reserved (ULONG) - input
Reserved, must be set to zero.
rc (USHORT) - return
Return code descriptions are:
0 NO_ERROR
2 ERROR_FILE_NOT_FOUND
3 ERROR_PATH_NOT_FOUND
5 ERROR_ACCESS_DENIED
26 ERROR_NOT_DOS_DISK
32 ERROR_SHARING_VIOLATION
36 ERROR_SHARING_BUFFER_EXCEEDED
87 ERROR_INVALID_PARAMETER
108 ERROR_DRIVE_LOCKED
206 ERROR_FILENAME_EXCED_RANGE
267 ERROR_DIRECTORY
Remarks
DosCopy copies all files and subdirectories in the source path to the
target path. Global file name characters are not allowed in source or
target names. The source and the target may be on different drives.
In the event of an I/O error, DosCopy takes the following actions before
it terminates:
o If the source name is that of a subdirectory, the file being copied at
the time of the error is deleted from the target path.
o If the source name is that of a file to be replaced, the file is
deleted from the target path.
o If the source name is that of a file to be appended, the target file is
resized to its original size.
Read-only files cannot be replaced by a DosCopy request. If OpMode bit
flag0 is set to 1 and read-only files exist in the target, an attempt to
replace them with files from the source returns an error.
File attributes are always copied from the source to the target; however
extended attributes (EAs) are not copied in every case. DosCopy copies
EAs from the source to the target when creating a file or directory or
when replacing an existing file on the target. However, it does not copy
them when appending an existing file or when copying files to an existing
directory on the target.
If a device name is specified as the target, the source name must be a
file, not a directory. When the request is issued, OpMode bit flags 0
and 1 are ignored.
DosQSysInfo is called by an application during initialization to
determine the maximum path length allowed by OS/2.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs