.net 如何引用迅雷组件

本文记录两个部分，本人自己引用迅雷组件的经历和引用迅雷组件相关原理

the first:

添加引用 -> COM -> ThunderAgent 1.0 Type Library（前提是已安装迅雷）

string path = "**";//下载任务url

ThunderAgentLib.AgentClass thunderObj = new ThunderAgentLib.AgentClass();
if (thunderObj == null)
return;
thunderObj.AddTask(path, "", "", "", "", 1, 1, 1); //添加下载任务
thunderObj.CommitTasks(); //提交下载任务，异步方式

the second:

1.首先导入DLL
添加引用 -> COM -> ThunderAgent 1.0 Type Library（前提是已安装迅雷）
或者C:/Program Files/Thunder Network/Thunder/ComDlls/ThunderAgent_Now.dll（路径可能有所不同）
2.代码：
THUNDERAGENTLib.AgentClass agent = new THUNDERAGENTLib.AgentClass();//创建对象
//添加任务：下载http://www.baidu.com/index.html这个文件至C:/baidu.html，
//没有注释，没有引用，立即开始，从多资源下载，原始资源线程5
agent.AddTask(“http://www.baidu.com/index.html”, “index.html”, “C://”, “”, “”, 1, 0, 5);
agent.CommitTasks2(1);//提交
3.修改迅雷配置
此时代码部分完成，但是运行的时候会弹出窗口确认下载。
如果想跳过这个窗口，需要在迅雷里面配置：工具》配置》高级》通过IE右键菜单“使用迅雷下载”添加任务，将这项去掉就可以了
附：方法详细说明
void AddTask(string pURL, string pFileName, string pPath, string pComments, string pReferURL, int nStartMode, int nOnlyFromOrigin, intnOriginThreadCount);
参数名 含义
pURL 目标URL，必须参数
pFileName 另存名称，默认为空，表示由迅雷处理，可选参数
pPath 存储目录，默认为空，表示由迅雷处理，可选参数
pComments 下载注释，默认为空，可选参数
pReferURL 引用页URL，默认为空，可选参数
nStartMode 开始模式，0手工开始，1立即开始，默认为-1，表示由迅雷处理，可选参数
nOnlyFromOrigin 是否只从原始URL下载，1只从原始URL下载，0多资源下载，默认为0，可选参数
nOriginThreadCount 原始地址下载线程数，范围1-10，默认为-1，表示由迅雷处理，可选参数
三、迅雷的开发文档

获得信息
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，然后等函数返回后就可以从其他成员中取得该任务的信息。
使用C#调用旋风快车和迅雷下载文件
如下所示：
public static void DownloadByQQ(string url)
{
Type qqdown;//类型
object qqdowobj;//一个对象
object[] parameter = new object[6];//参数，因为我们调用的方法有6和参数。 所以定义了6个
if (url != null && url.Length >0)
{
qqdown = Type.GetTypeFromProgID(“QQIEHelper.QQRightClick.2″);//从progid创建类型
qqdowobj = Activator.CreateInstance(qqdown);//然后创建实例
parameter[0] = url;//第一个参数是url
parameter[1] = url ;//第二个参数是引用url,这里我们填成一样的
parameter[2] = “www.mp3114.cn”;//注释信息
parameter[3] = null;
parameter[4] = 0;
parameter[5] = null;
qqdown.InvokeMember(“sendUrl2″, BindingFlags.InvokeMethod, null, qqdowobj, parameter);//使用invokemember调用方法
//BindingFlags 中有很多枚举，分别是用于调用方法或者属性的设置 获取等绑定标记。 你可以参考一下msdn
}
}
//看到这里你也许已经明白如何做了。 如果还不明白呢。 接着看一遍。 或者把代码贴到程序里单步调试一遍就自然明白啦。
public static void DownloadByThunder(string url)
{
Type ThunderAgent;// = new ActiveXObject(“ThunderAgent.Agent”);
object objThunderAgent;
object[] parameter = new object[14];
if (url != null && url.Length > 0)
{
ThunderAgent = Type.GetTypeFromProgID(“ThunderAgent.Agent”);
objThunderAgent = Activator.CreateInstance(ThunderAgent);
parameter[0] = url;
parameter[1] = “”;
parameter[2] = “”;
parameter[3] = “www.mp3114.cn”;
parameter[4] = url ;
parameter[5] = -1;
parameter[6] = 0;
parameter[7] = -1;
parameter[8] = “”;//strCookie
parameter[9] = “”;
parameter[10] = “”;
parameter[11] = 1;
parameter[12] = “”;
parameter[13] = -1;
ThunderAgent.InvokeMember(“AddTask5″, BindingFlags.InvokeMethod, null, objThunderAgent, parameter);
// ThunderAgent.AddTask5(Url, “”, “”, Info, Location, -1, 0, -1, strCookie, “”, “”, 1, “”, -1);
object[] parm = new object[1];
parm[0] = 1;
ThunderAgent.InvokeMember(“CommitTasks2″, BindingFlags.InvokeMethod, null, objThunderAgent, parm);
}
}
public static void DownloadByFlashGet(string url)
{
Type FlashGet;
object objFlashGet;
object[] parameter = new object[5];
if (url != null && url.Length > 0)
{
FlashGet = Type.GetTypeFromProgID(“BHO.IFlashGetNetscapeEx”);
objFlashGet = Activator.CreateInstance(FlashGet);
parameter[0] = url;
parameter[1] = “www.mp3114.cn”;
parameter[2] = url;
parameter[3] = “FlashGet”;
parameter[4] = 0;
FlashGet.InvokeMember(“AddUrlEx”, BindingFlags.InvokeMethod, null, objFlashGet, parameter);
}
}