Функция InetGetInfo

         Описание функции


InetGetInfo

Возвращает информацию о загрузке, начатой с помощью InetGet().

InetGetInfo ( [ handle [, index = -1 ]] )

Параметры

handle [необязательный] Дескриптор, возвращённый функцией InetGet().
index [необязательный] Индекс возвращаемых данных.
    -1 - (по умолчанию) будет возвращён массив со всеми данными.
    0 - число загруженных байтов (обновляется по мере загрузки).
    1 - размер загружаемого файла (это число не всегда может быть предоставлено).
    2 - равно True, если загрузка завершена, False, если загрузка всё ещё в процессе.
    3 - True, если загрузка была завершена успешно. Если False, следующий (4) элемент массива будет не равен нулю.
    4 - значение ошибки для загрузки. Само значение является произвольным. Проверки, что значение не равно нулю, достаточно для определения, произошла ли ошибка при загрузке.
    5 - расширенное значение для загрузки. Значение произвольно, и, в первую очередь полезно только для разработчиков AutoIt.

Возвращаемое значение

Успех:Возвращает запрашиваемые данные.
Ошибка:Возвращает пустую строку и устанавливает значение @error не равным нулю.

Примечания

Функция, вызванная без параметров, вернёт общее число активных закачек.
Эта функция может быть вызвана в цикле, чтобы запрашивать количество загруженных байтов или приостановить до тех пор, пока загрузка не завершится.

См. также

InetGet

Пример

Local $hDownload = InetGet("http://www.autoitscript.com/autoit3/files/beta/update.dat", @TempDir & "\update.dat", 1, 1)
Do
    Sleep(250)
Until InetGetInfo($hDownload, 2) ; Проверка выполнения полной загрузки.
Local $aData = InetGetInfo($hDownload) ; Возвращает всю информацию.
InetClose($hDownload) ; Закрывает дескриптор, чтобы освободить ресурсы.
MsgBox(4096, "", "Количество прочитанных байт: " & $aData[0] & @CRLF & _
        "Размер: " & $aData[1] & @CRLF & _
        "Полное завершение: " & $aData[2] & @CRLF & _
        "Успешность выполнения: " & $aData[3] & @CRLF & _
        "@error: " & $aData[4] & @CRLF & _
        "@extended: " & $aData[5] & @CRLF)