标签：
今天到迅雷公司的SDK文档网站上逛了逛，竟然发现它们已经提供了完备的API接口，我心中不禁大喜，但是SDK资料中的原版开发文件已经很难找到了，幸运的是我在github上搜索到了所需的文件，在这里我已经打包完毕，点击 这里 下载。
在这个SDK中，包含有.h头文件，lib库文件，dll动态链接库文件，迅雷公司，我们首先用VC++提供的Depends工具查看一下dll文件中的函数列表。
从这个函数列表图片，可以看出SDK中提供的功能还是很全面的，对于下载功能的封装还是挺让人满意。下面我来按照代码执行顺序对函数进行相关的解释
| XLInitDownloadEngine | BOOL __stdcall XLInitDownloadEngine(); | 初始化迅雷下载引擎。 |
| XLURLDownloadToFile |  |
根据URL开启下载。 |
| XLQueryTaskInfo |  |
查询指定任务当前状态。 |
| XLStopTask | VOID __stdcall XLStopTask(LONG lTaskId); | 停止指定任务(必须)。 |
| XLUninitDownloadEngine | BOOL __stdcall XLUninitDownloadEngine(); | 进行资源回收操作。 |
上面的函数是一个完整的工作流程，下面我们继续把其他函数做一下介绍。
| XLPauseTask | DWORD __stdcall XLPauseTask(LONG lTaskId, LONG & lNewTaskId); | 暂停指定任务。 |
| XLContinueTask | DWORD __stdcall XLContinueTask(LONG lTaskId); | 根据编号继续下载。 |
| XLContinueTaskFromTdFile |  |
根据TD文件继续下载。 |
| XLGetErrorMsg |  |
将错误码对应的错误消息拷贝至指定的缓冲区。 |
特殊参数类型 LONG &：直接定义LONG类型变量，传进函数即可。
下面我对样例代码进行一些解释
1 //VS2008 UNICODE 2 #include "stdafx.h" 3 #include <stdio.h> 4 #include "stdlib.h" 5 #include <windows.h> 6 #include "XLDownload.h" 7 #include "XLError.h" 8 #pragma comment(lib, "XLDownload.lib") 9 10 // 唯一的应用程序对象 11 12 int _tmain(int argc, TCHAR* argv[], TCHAR* envp[]) 13 { 14 // 1、初始化下载引擎 15 if ( FALSE == XLInitDownloadEngine() ) 16 { 17 printf("Initialize download engine failed.\n"); 18 return 1; 19 } 20 // 2、启动新任务 21 // PS：如果链接无法通过，请把工程属性“将wchar_t设置为内置类型 (/Zc:wchar_t)”设置为Yes 22 LONG lTaskId = 0; 23 DWORD dwRet = XLURLDownloadToFile( //这里开始下载，迅雷把下载和状态查询进行了分离，创新之处 24 _T("d:\\notepad++.exe"), 25 _T("http://dlsw.baidu.com/sw-search-sp/soft/cc/13478/npp.6.7.4.Installer.1421032427.exe"), 26 _T(""), lTaskId); 27 28 printf("Begin download file.\n"); 29 30 // 3、查询任务状态 31 do 32 { 33 ::Sleep(1000); 34 system("cls"); //windows 清屏 35 ULONGLONG ullFileSize = 0; 36 ULONGLONG ullRecvSize = 0; 37 LONG lStatus = -1; 38 39 dwRet = XLQueryTaskInfo(lTaskId, &lStatus, &ullFileSize, &ullRecvSize); 40 if ( XL_SUCCESS==dwRet ) 41 { 42 // 输出进度信息 43 if ( 0 != ullFileSize ) 44 { 45 double douProgress = (double)ullRecvSize/(double)ullFileSize; 46 // printf("%.2lfMB",(double)ullRecvSize/8/1024/1024); 47 douProgress *= 100.0; 48 printf("Download progress:%.2f%% %.2lfMB\n", douProgress,(double)ullRecvSize/1024/1024); 49 } 50 else 51 { 52 printf("File size is zero.\n"); 53 } 54 55 if ( enumTaskStatus_Success==lStatus ) 56 { 57 printf("Download successfully.\n"); 58 break; 59 } 60 61 if ( enumTaskStatus_Fail==lStatus ) 62 { 63 printf("Download failed.\n"); 64 break; 65 } 66 } 67 } while( XL_SUCCESS==dwRet ); 68 69 // 4、无论是否下载成功，都必须调用XLStopTask 70 XLStopTask(lTaskId); 71 72 // 5、释放资源 73 XLUninitDownloadEngine(); 74 return 0; 75 }
标签：
原文地址：http://www.cnblogs.com/corerman/p/4726933.html
