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)