Опыт применения REXX FTP API - Коды возврата

Индекс материала
Опыт применения REXX FTP API
Введение
Установка
Коды возврата
Функции
Замечания по применению
Послесловие

4. Коды возврата.

Функции REXX FTP API сообщают вызывающей программе об успешном или неуспешном выполнении с помощью кодов возврата и специальной переменной FTPERRNO.

Но делают это совершенно разными способами:

  1. Большинство функций возвращает одно из следующих значений:

    Значение Описание
    0 нормальное завершение, ошибок нет;
    специальной переменной FTPERRNO присвоено значение 0
    -1 ошибка во время выполнения;
    код ошибки помещён в специальную переменную FTPERRNO

    Специальной переменной FTPERRNO присваивается одно из следующих значений:

    Значение Описание
    0 нормальное завершение, ошибок нет
    FTPSERVICE неизвестный сервис
    FTPHOST неизвестный хост
    FTPSOCKET невозможно получить сокет
    FTPCONNECT невозможно соединиться с сервером
    FTPLOGIN регистрация не выполнена
    FTPABORT передача данных прервана
    FTPLOCALFILE проблемы с открытием локального файла
    FTPDATACONN проблемы с инициализацией соединения
    FTPCOMMAND выполнение команды прервано, соединение с сервером может быть разорвано
    FTPPROXYTHIRD прокси-сервер не поддерживает передачу третьей стороне
    FTPNOPRIMARY нет первичного соединения для передачи по доверенности (proxy transfer)
    FTPFAILURE команда не выполнена, соединение с сервером сохранено
  2. Функция FtpSys() возвращает одно из следующих значений:

    Значение Описание
    <строка> нормальное завершение, ошибок нет;
    строка содержит описание операционной системы сервера FTP;
    специальной переменной FTPERRNO присвоено значение 0
    -1 ошибка во время выполнения;
    код ошибки помещён в специальную переменную FTPERRNO

    Коды ошибок специальной переменной FTPERRNO смотри выше.

  3. Функция FtpVersion() всегда возвращает пустую строку ("").

    Cпециальной переменной FTPERRNO всегда присваивается значение 0.

  4. Функции FtpSetActiveMode(), FtpSetBinary() и FtpSetUser() возвращают одно из следующих значений:

    Значение Описание
    1 нормальное завершение, ошибок нет
    0 ошибка, требуемое действие не выполнено

    Cпециальной переменной FTPERRNO всегда присваивается значение 0.

  5. Функция FtpPing() возвращает одно из следующих значений:

    Значение Описание
    <число> нормальное завершение, ошибок нет;
    время в миллисекундах, прошедшее от отправки запроса до получения ответа
    PINGREPLY хост не отвечает
    PINGSOCKET невозможно получить сокет
    PINGPROTO неизвестный протокол ICMP
    PINGSEND передача завершилась с ошибкой
    PINGRECV приём завершился с ошибкой
    PINGHOST неизвестный хост

    Cпециальной переменной FTPERRNO всегда присваивается значение 0.

  6. Функции FtpLoadFuncs() и FtpDropFuncs() возвращают 0 в случае успешного выполнения.

    Значение специальной переменной FTPERRNO не изменяется.