используется текущая директория на текущем
необязательными именем диска и путем доступа. По умолчанию
используется текущая директория на текущем диске. Диск, файл и
директория обязательно должны находиться на текущем файл-сервере.
<cTargetFile> - символьная строка, задающая имя выходного файла с
необязательными именем диска и путем доступа. По умолчанию
используется текущая директория на текущем диске. Диск и директория
обязательно должны находиться на текущем файл-сервере.
<nBytes> - необязательный числовой параметр, задающий количество
копируемых байтов. По умолчанию копируется весь файл.
Возвращаемое значение
nCopiedBytes - число скопированных байтов при успешном копировании,
или (-1) при невозможности копирования.
Описание
Функция позволяет из прикладной программы произвести такое же
копирование в пределах одного файл-сервера (без пересылки по сети и
поэтому с максимальной скоростью), как и выполняемое сетевой утилитой
NCOPY.
Примечания
. Если размер копируемого файла известен (напр., в результате
последовательности вызовов FILESEEK() и FILESIZE(), то целесообразно
задавать эту величину в параметре <nBytes>. Это позволит избежать
дополнительных трат сетевых ресурсов на повторное выявление длины.
. Выходной файл может быть помещен только на тот же файл-сервер, где
расположен исходный файл. С помощью данной функции нельзя производить
копирование на не сетевые диски, а также с одного файл-сервера на
другой. Для этих целей следует использовать другие средства, например,
функцию FILECOPY().
. Уточнение причины ошибки можно произвести с помощью функций
ERRORCODE() и NNETERROR().
Примеры
. Копирование на сетевом диске J, отображаемом на том или директорию
текущего файл-сервера:
NNETCOPY("J:\SUPPORT\TEST.EXE", "J:\USER\TEST2.EXE")