Клиппер 5. Справочник


Клиппер 5. Справочник - часть 526


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



Начало  Назад  Вперед