InetGet
Загружает файл из интернета, используя протоколы HTTP, HTTPS или FTP и сохраняет его на диске.
InetGet ( "URL" [, "filename" [, options = 0 [, background = 0 ]]] )
Параметры
URL | Путь к файлу для загрузки. См. примечания ниже. |
filename |
[необязательный] Имя локального файла (куда будет загружен файл). |
options |
[необязательный] 0 = (по умолчанию) получить файл из кэша, если это возможно. 1 = принудительно перезагрузить с удалённого сайта. 2 = игнорировать все SSL ошибки (при использовании соединения HTTPS). 4 = использовать ASCII при передаче файлов с помощью протокола FTP (не может быть совмещено с флагом 8). 8 = использовать BINARY при передаче файлов с помощью протокола FTP (не может быть совмещено с флагом 4). Это режим передачи файлов по умолчанию, если не указано иное. 16 = пропускать проверку соединения (см. примечания). |
background |
[необязательный] 0 = (по умолчанию) подождать, пока загрузка не будет полностью завершена, прежде чем продолжить выполнение скрипта. 1 = не ждать завершения загрузки и продолжать загрузку в фоновом режиме (см. примечания). |
Возвращаемое значение
Возвращаемое значение зависит от параметра background:Успех: | В фоне (1): функция возвращает дескриптор. Этот дескриптор может использоваться в функции InetGetInfo(). Он должен быть закрыт с помощью InetClose(). |
Ожидание (0): число загруженных байтов. | |
Ошибка: | В фоне (1): функция возвращает дескриптор. Чтобы узнать, произошли ли с загрузкой какие-нибудь проблемы, используйте функцию InetGetInfo(). Дескриптор должен быть закрыт с помощью функции InetClose(). |
Ожидание (0): устанавливает значение @error не равным нулю и возвращает 0. |
Примечания
Для работы этой функции должен быть установлен Internet Explorer версии 3 или выше.См. также
InetGetSize, InetRead, InetGetInfo, InetClose, HttpSetProxy, FtpSetProxy, HttpSetUserAgentПример
InetGet("http://www.mozilla.org", @TempDir & "\mozilla.html")
InetGet("http://www.autoitscript.com", @TempDir & "autoitscript.html", 1)
InetGet("ftp://ftp.mozilla.org/pub/mozilla.org/README", @TempDir & "\Mozilla-README.txt", 1)
; Улучшенный пример - скачивание в фоновом режиме
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 $nBytes = InetGetInfo($hDownload, 0)
InetClose($hDownload) ; Закрыть дескриптор, чтобы освободить ресурсы.
MsgBox(4096, "", "Количество прочитанных байт: " & $nBytes)