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

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

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 не изменяется.



Главное меню