#include<nwfile.h> or #include <nwcalls.h>NWCCODE N_API NWFileServerFileCopy (NWFILE_HANDLE srcFileHandle, NWFILE_HANDLE dstFileHandle, nuint32 srcOffset, nuint32 dstOffset, nuint32 bytesToCopy, pnuint32 bytesCopied);
If the source and destination files do not reside on the same server, NOT_SAME_CONNECTION is returned.
An application must pass OS file handles in srcFileHandle and dstFileHandle. The application should use the appropriate OS functions that create and open files to return the file handles, depending on whether the destination file is a new or an existing file.
If the destination file is new, bytesCopied points to the size of the destination file. Otherwise, bytesCopied points to the number of bytes copied.
To copy the entire source file, specify a value that matches or exceeds the file size in bytesToCopy.
NWFileServerFileCopy is very efficient since the data does not come to the workstation; the server handles the duplication of the data internally.
Under OS/2, the given handles are converted to NetWare handles via the NetWare IFS.
Under DOS, NWFileServerFileCopy is a direct call to the shell, and the shell handles the copy.
File Systems