迅雷API：實現文件下載

　　 今天到迅雷公司的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類型變量，傳進函數即可。

---

      下面我對樣例代碼進行一些解釋

//VS2008 UNICODE
#include "stdafx.h"
#include <stdio.h>
#include "stdlib.h"
#include <windows.h>
#include "XLDownload.h"
#include "XLError.h"
#pragma comment(lib, "XLDownload.lib")

// 唯一的應用程序對象

int _tmain(int argc, TCHAR* argv[], TCHAR* envp[])
{
    // 1、初始化下載引擎
    if ( FALSE == XLInitDownloadEngine() )
    {
        printf("Initialize download engine failed.\n");
        return 1;
    }
    // 2、啟動新任務
    // PS：如果鏈接無法通過，請把工程屬性“將wchar_t設置為內置類型        (/Zc:wchar_t)”設置為Yes
    LONG   lTaskId = 0;
    DWORD  dwRet   = XLURLDownloadToFile( //這里開始下載，迅雷把下載和狀態查詢進行了分離，創新之處
        _T("d:\\notepad++.exe"), 
        _T("http://dlsw.baidu.com/sw-search-sp/soft/cc/13478/npp.6.7.4.Installer.1421032427.exe"), 
        _T(""), lTaskId);

    printf("Begin download file.\n");

    // 3、查詢任務狀態
    do 
    {
        ::Sleep(1000);
        system("cls"); //windows 清屏
        ULONGLONG   ullFileSize = 0;
        ULONGLONG   ullRecvSize = 0;
        LONG        lStatus     = -1;

        dwRet = XLQueryTaskInfo(lTaskId, &lStatus, &ullFileSize, &ullRecvSize);
        if ( XL_SUCCESS==dwRet )
        {
            // 輸出進度信息
            if ( 0 != ullFileSize )
            {
                double  douProgress = (double)ullRecvSize/(double)ullFileSize;
            //    printf("%.2lfMB",(double)ullRecvSize/8/1024/1024);
                douProgress *= 100.0;
                printf("Download progress:%.2f%%   %.2lfMB\n", douProgress,(double)ullRecvSize/1024/1024);
            }
            else
            {
                printf("File size is zero.\n");
            }

            if ( enumTaskStatus_Success==lStatus )
            {
                printf("Download successfully.\n");
                break;
            }

            if ( enumTaskStatus_Fail==lStatus )
            {
                printf("Download failed.\n");
                break;
            }
        }
    } while( XL_SUCCESS==dwRet );

    // 4、無論是否下載成功，都必須調用XLStopTask
    XLStopTask(lTaskId);

    // 5、釋放資源
    XLUninitDownloadEngine();
    return 0;
}