基 础 函 数 参 考

InetGet

使用 HTTP,HTTPS 或 FTP 协议下载文件.

InetGet ( "URL(网址)" [, "文件名" [, 选项 [, 后台]]] )

参 数

URL(网址) 下载文件的 URL(地址). 参阅备注.
文件名 [可选参数] 下载到本地的文件名称.
选项 [可选参数] 0 = (默认)如有可能则从本地缓存中获取文件.
1 = 强制重新加载远程站点.
2 = 忽略所有 SSL 错误(使用 HTTPS 连接时).
4 = 使用 FTP 协议传输 ASCII 文件(不能和标志 8 一起使用).
8 = 使用FTP协议传输二进制文件时(不能和标志 4 一起使用). 这是默认传输方式.
16 = 强制在线连接 (见备注).
后台 [可选参数] 0 = (默认)等待下载完成之后执行脚本后面的语句.
1 = 立即返回并在后台完成下载 (见备注).

返 回 值

成功: 返回值取决于是否使用后台下载:
后台下载: 返回句柄. 句柄可以用于 InetGetInfo(), 且必须使用 InetClose() 关闭.
等待下载: 返回下载的字节数.
失败: 后台下载: 返回句柄. 使用 InetGetInfo() 确定是否有下载错误. 句柄必须使用 InetClose() 关闭.
等待下载: 设置 @error 为非 0 值, 并返回 0.

备 注

必须 Internet Explorer 3 或更高版本.

URL 参数的形式: "http://www.somesite.com/path/file.html" - 如同在网页浏览器中输入的地址.

指定用户名及密码,只要在服务器前加 "用户名:密码@", 例如:
"http://myuser:mypassword@www.somesite.com"

关于 "后台" 参数的说明

函数默认等待, 直到下载在返回之前完成. 如果 "后台" 参数设置为 1, 函数立即返回, 并在后台继续下载.
此时可传递 InetGet() 返回的句柄到 InetGetInfo() 函数检查下载的状态.

后台下载模式支持多文件下载.

要终止下载, 传递 InetGet() 返回的句柄到 InetClose().

默认 AutoIt 开始下载前强制连接. 对于拨号上网用户将提示联机或调制解调器拨号(取决于系统配置而定). 选项值 16 将禁用此行为.
提示对于关闭 Broadband(宽带), LAN(局域网)的持久性连接非常有用.
但也需要解决某些 Windows Vista 与 Windows 7 的问题.

相 关 函 数

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(0, "", "读取字节: " & $nBytes)

provider with jb51.net (unicode)