【转】vs2005调用迅雷完美解决方案
来源:互联网 发布:生产型进销存软件 编辑:程序博客网 时间:2024/06/04 08:43
出处:http://www.cnblogs.com/yuanbao/archive/2008/02/25/1080327.html
我们网络程序中,经常用到下载功能。当然,我们可以自己写一个下载程序,但笔者认为调用已有的较成熟下载工具来完成这项工作,是一种更为实用有效的方法。笔者平时用得最多是迅雷,经查,它提供了COM接口,在Vs2005中实现调用就非常简单了。
一、VS.net中调用迅雷
首先确保电脑已经安装讯雷,打开VS.NET 点击菜单:项目->添加引用->COM->添加对ThunderAgent 1.0 Type Library的引用。如图1
图1
1 THUNDERAGENTLib.AgentClass thunderObj= new THUNDERAGENTLib.AgentClass();
2 thunderObj.AddTask("下载地址", "另存文件名", "保存目录", "任务注释", "引用地址", "开始模式", "只从原始地址下载", "从原始地址下载线程数"); //添加下载任务
3 thunderObj.CommitTasks2(1); //提交下载任务,异步方式
二、静悄悄的后台运行迅雷
默认情况下,往迅雷添加任务时会弹出窗口让我们进行相关设置,这个功能有一定作用,但对我编程实现说就太多余了。事实上,我们完全可以将此功能关闭:右击悬 浮窗,选择“配置”命令,再单击“任务默认属性”项,将下载的目录指向一个较大空间的硬盘, 如果是c:\TDdownload文件夹,请确认C盘上一定要有足够空间(如图2)。否则,下载的文件大了,就可能会使得C盘空间不够,从而影响下载。接 着,再单击“高级”项,然后取消“操作确认”和“显示提示”项下的所有选项(如图3)。这样,我们将添加任务时,就会自动下载,而不会弹 出添加任务确认窗口了。
图3
三、迅雷的开发文档
获得信息
1. BSTR GetInfo(BSTR pInfoName)
功能:获得迅雷或平台相关信息
参数:
参数名
含义
pInfoName
信息名称,有如下4种
◆“ThunderExists”:迅雷是否存在
◆“ThunderRunning”:迅雷是否运行
◆“ThunderVersion”:迅雷版本号
◆“PlatformVersion”:平台版本号
返回值:返回值是字符串与参数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类型;调用后结构中将填充平台信息,定义如下:
typedef struct _THUNDER_INFO
{
BOOL bThunderExists;
BOOL bThunderRunning;
CHAR szThunderVersion[32];
CHAR szPlatformVersion[32];
} THUNDER_INFO;
函数调用后,结构中将填充相应的信息。
返回值:
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
状态名称,有如下几种
◆“Exists”:pURL是否在迅雷的任务列表
◆“Path”:存储目录
◆“FileName”:文件名称
◆“FileSize”:文件大小
◆“CompletedSize”:已下载大小
◆“Percent”:下载进度
◆“Status”:任务状态
返回值: 返回值是字符串与参数pInfoName有对应关系
参数
返回值
“Exists”
”true”存在,”false”不存在
“Path”
存储目录,最后带反斜线\,例:C:\TDDownload\
“FileName”
文件名称
“FileSize”
文件大小,以字节为单位,0表示大小未知
“CompletedSize”
已下载大小,以字节为单位
“Percent”
下载进度,带1位小数,例:70.0
“Status”
任务状态,有以下6种状态
。“running”: 运行状态
。“stopped”: 停止状态
。“failed”: 失败状态
。“success”: 成功状态
。“creatingfile”:正在创建数据文件
。“connecting”: 正在连接
7. GetTaskInfoStruct(INT pTaskInfo)
功能:查询一个任务的所有信息
参数名
含义
pTaskInfo
其实是THUNDER_TASKINFO类型的结构指针,调用前把它转换为INT类型;调用后结构中将填充平台信息,定义如下:
typedef struct _THUNDER_TASKINFO
{
CHAR szURL[1024]; // 任务URL,预先填充
BOOL bTaskExists; // 任务是否存在,TRUE为存在
CHAR szPath[256]; // 下载的本地保存路径
CHAR szFileName[256]; // 本地文件名
ULONGLONG nFileSize; // 文件大小
ULONGLONG nCompletedSize; // 已完成的大小
CHAR szPercent[16]; // 完成的百分数,用 “56.8”的格式
CHAR szStatus[16]; // 当前状态,定义同GetTaskInfo函数
} THUNDER_TASKINFO;
调用者先填充结构中的szURL成员,来指定需要查询的任务的URL,然后等函数返回后就可以从其他成员中取得该任务的信息。
- 【转】vs2005调用迅雷完美解决方案
- 完美界面换肤解决方案 vc调用delphi皮肤库
- 调用系统相机/相册获取图片的完美解决方案
- 。net 调用迅雷
- .NET如何调用迅雷
- 迅雷api 下载 调用
- 网页调用迅雷下载
- 迅雷调用potplayer
- 【转】VS2005无法启动调试的解决方案
- JBuilder中文问题完美解决方案(转)
- android汉字转拼音的完美解决方案
- VS2005找不到解决方案
- VS2005..解决方案.无法显示
- VS2005(C#)异常解决方案
- c# 调用迅雷下载漫画
- 调用迅雷api下载资源
- 调用迅雷api下载资源
- VC++调用迅雷下载文件
- Android中替换ExpandableListView控件前面的箭头图标
- ubuntu设置PATH
- 4. ios UIScrollView的属性总结
- ubuntu gedit出错:Failed to connect to the session manager
- t-code SE30(SAT)分析ABAP程序
- 【转】vs2005调用迅雷完美解决方案
- t-code ST05 trace的用法和分析
- cocos2d-x学习笔记
- 关于setjmp longjmp的使用
- Structed Exception Handler 学习总结(二)
- 《UNIX环境高级编程》笔记--打开流
- 计算机的性能指标
- 出口程序的查找和开发(CMOD和SMOD)
- python使用CSV实现电话本