vs2005调用迅雷完美解决方案
我们网络程序中,经常用到下载功能。当然,我们可以自己写一个下载程序,但笔者认为调用已有的较成熟下载工具来完成这项工作,是一种更为实用有效的方法。笔者平时用得最多是迅雷,经查,它提供了COM接口,在Vs2005中实现调用就非常简单了。
一、VS.net中调用迅雷
首先确保电脑已经安装讯雷,打开VS.NET 点击菜单:项目->添加引用->COM->添加对ThunderAgent 1.0 Type Library的引用。如图1
图1
1
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
2
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
3
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
二、静悄悄的后台运行迅雷
默认情况下,往迅雷添加任务时会弹出窗口让我们进行相关设置,这个功能有一定作用,但对我编程实现说就太多余了。事实上,我们完全可以将此功能关闭:右击悬 浮窗,选择“配置”命令,再单击“任务默认属性”项,将下载的目录指向一个较大空间的硬盘, 如果是c:\TDdownload文件夹,请确认C盘上一定要有足够空间(如图2)。否则,下载的文件大了,就可能会使得C盘空间不够,从而影响下载。接 着,再单击“高级”项,然后取消“操作确认”和“显示提示”项下的所有选项(如图3)。这样,我们将添加任务时,就会自动下载,而不会弹 出添加任务确认窗口了。
图3
三、迅雷的开发文档
获得信息
1. BSTR GetInfo(BSTR pInfoName)
功能:获得迅雷或平台相关信息
参数:
参数名 |
含义 |
pInfoName |
信息名称,有如下4种 |
返回值:返回值是字符串与参数pInfoName有对应关系
参数 |
返回值 |
“ThunderExists” |
“true”存在,“false”不存在 |
“ThunderRunning” |
“true” 运行中, “false”未运行 |
“ThunderVersion” |
迅雷版本号 “x.x.x.x” |
“PlatformVersion” |
平台版本号 “x.x.x.x” |
2. HRESULT GetInfoStruct(INT pInfo)
功能:获取迅雷或平台相关全部信息
参数:
参数名 |
含义 |
pInfo |
其实是THUNDER_INFO类型的结构指针,调用前把它转换为INT类型;调用后结构中将填充平台信息,定义如下: |
返回值:
0 |
获取成功 |
非0 |
获取失败 |
任务操作
3. 加入任务
HRESULT AddTask
(BSTR pURL,
BSTR pFileName = "",
BSTR pPath = "",
BSTR pComments = "",
BSTR pReferURL = "",
INT nStartMode = -1,
INT nOnlyFromOrigin = 0,
INT nOriginThreadCount = -1);
功能:
往平台加入下载任务信息,此时尚未体现到迅雷中
参数:
参数名 |
含义 |
pURL |
目标URL,必须参数 |
pFileName |
另存名称,默认为空,表示由迅雷处理,可选参数 |
pPath |
存储目录,默认为空,表示由迅雷处理,可选参数 |
pComments |
下载注释,默认为空,可选参数 |
pReferURL |
引用页URL,默认为空,可选参数 |
nStartMode |
开始模式,0手工开始,1立即开始,默认为-1,表示由迅雷处理,可选参数 |
nOnlyFromOrigin |
是否只从原始URL下载,1只从原始URL下载,0多资源下载,默认为0,可选参数 |
nOriginThreadCount |
原始地址下载线程数,范围1-10,默认为-1,表示由迅雷处理,可选参数 |
4. 开始任务
HRESULT CommitTaskss()
功能:
把AddTask所加入的下载任务信息真正提交到迅雷中进行下载,并从平台中删除
注意:如果AddTask添加的任务没有被提交没有被取消(调用CancelTasks),则Agent对象析构时会阻塞,所以调用者不应该残留一些没有被提交或者取消的任务,以避免脚本执行者停止响应。
5. 取消任务
HRESULT CancelTasks()
功能:
取消平台中所有由AddTask所加入的下载任务信息
6. 查询任务信息
BSTR GetTaskInfo(BSTR pURL,BSTR pInfoName);
参数:
参数名 |
含义 |
pURL |
所要查询的下载URL信息 |
pInfoName |
状态名称,有如下几种 |
返回值: 返回值是字符串与参数pInfoName有对应关系
参数 |
返回值 |
“Exists” |
”true”存在,”false”不存在 |
“Path” |
存储目录,最后带反斜线\,例:C:\TDDownload\ |
“FileName” |
文件名称 |
“FileSize” |
文件大小,以字节为单位,0表示大小未知 |
“CompletedSize” |
已下载大小,以字节为单位 |
“Percent” |
下载进度,带1位小数,例:70.0 |
“Status” |
任务状态,有以下6种状态 |
7. GetTaskInfoStruct(INT pTaskInfo)
功能:查询一个任务的所有信息
参数名 |
含义 |
pTaskInfo |
其实是THUNDER_TASKINFO类型的结构指针,调用前把它转换为INT类型;调用后结构中将填充平台信息,定义如下: |