文件傳送協(xié)議（FTP — File Transfer Protocol）是TCP/IP提供的標(biāo)準(zhǔn)機(jī)制，用來從一臺(tái)主機(jī)將文件復(fù)制到另一臺(tái)主機(jī)。從一臺(tái)計(jì)算機(jī)向另一臺(tái)計(jì)算機(jī)傳送文件是在聯(lián)網(wǎng)或互聯(lián)網(wǎng)環(huán)境中常見的任務(wù)。

      英創(chuàng)ARM9系列工控主板預(yù)裝正版WinCE5.0操作系統(tǒng)，WinCE內(nèi)核提供了FTP Server應(yīng)用程序，這為通過FTP實(shí)現(xiàn)文件傳送提供了方便，在本公司網(wǎng)站文章《ARM9工控主板WinCE應(yīng)用程序的遠(yuǎn)程FTP自動(dòng)更新》中介紹的方案，就是利用WinCE內(nèi)核提供的FTP Server實(shí)現(xiàn)的應(yīng)用程序遠(yuǎn)程更新。但在很多應(yīng)用場合，是工控主板作為本地FTP客戶端與遠(yuǎn)端FTP服務(wù)器交換文件，為此需要程序員自己編寫在ARM9主板上運(yùn)行的FTP客戶端的程序。對(duì)于WinCE操作系統(tǒng)，Microsoft提供了如FtpGetFile()、FtpPutFile()等用于文件傳送的函數(shù)，程序員利用這些函數(shù)，可以方便的編寫出FTP客戶端程序。但如果網(wǎng)絡(luò)環(huán)境復(fù)雜或采用GPRS網(wǎng)絡(luò)，由于GPRS網(wǎng)絡(luò)原因，網(wǎng)絡(luò)連接很容易中斷，如果每次連接中斷，整個(gè)文件都重新傳送，一個(gè)稍大的文件基本上不能成功傳送，此時(shí)就要求FTP文件傳送具有斷點(diǎn)續(xù)傳功能。

      斷點(diǎn)續(xù)傳是指在文件的傳送過程中，因?yàn)榫W(wǎng)絡(luò)或其它原因至使傳送過程中斷，當(dāng)再次傳送這個(gè)文件時(shí)，將從已傳送的部份開始，繼續(xù)未完成部份傳送，不用從頭對(duì)整個(gè)文件進(jìn)行傳送，這樣可以節(jié)省時(shí)間，節(jié)約網(wǎng)絡(luò)流量，提高文件傳送速度。對(duì)于在GPRS網(wǎng)絡(luò)上應(yīng)用的FTP，斷點(diǎn)續(xù)傳功能顯得尤為重要，但Microsoft提供的FTP API中，卻沒有支持?jǐn)帱c(diǎn)續(xù)傳的函數(shù)，為此，英創(chuàng)公司針對(duì)斷點(diǎn)續(xù)傳這一要求，直接采用SOCKET API，封裝了一個(gè)支持?jǐn)帱c(diǎn)續(xù)傳的FTP客戶端靜態(tài)庫EM_FTPClient.LIB，下面對(duì)這個(gè)庫函的API函數(shù)做詳細(xì)說明。

      支持?jǐn)帱c(diǎn)續(xù)傳的FTP庫函數(shù)說明：

      （1）bool Logon( LPCTSTR lpszHostIP, LPCTSTR lpszUserName=_T(''),
                                  LPCTSTR lpszPassword=_T(''), int nTimeOut=5000 );
      功能描述：登錄到FTP服務(wù)器
      輸入?yún)��?shù) lpszHostIP：服務(wù)器IP
      lpszUserName：用戶名
      lpszPassword：用戶密碼(當(dāng)用戶名用與用戶密碼為空時(shí),將匿名登錄)
      nTimeOut：超時(shí)設(shè)置 1000(mS)<=nTimeOut<=60000(mS)
      返回值 = TRUE：登錄FTP服務(wù)器成功
      FALSE：登錄FTP服務(wù)器失敗

      （2）bool ChangeDir( LPCTSTR lpszRemoteDir=_T('\\') );
      功能描述：設(shè)置遠(yuǎn)端FTP服務(wù)器當(dāng)前目錄
      輸入?yún)��?shù) lpszRemoteDir：服務(wù)器目錄
      返回值 = TRUE：目錄更改成功
      FALSE：目錄更改失敗

      （3）bool ListAll(  FILELIST* fileList  );
       功能描述：獲取FTP服務(wù)器當(dāng)前目錄下的所有文件的列表
       輸入?yún)��?shù) fileList：接收文件列表的結(jié)構(gòu)體
      返回值 = TRUE：獲取文件列表成功
      = FALSE：獲致文件列表失敗
      文件列表數(shù)據(jù)結(jié)構(gòu)定義如下：
      typedef struct  
      {
            int  nFileNum;       //當(dāng)前目錄文件個(gè)數(shù)
            TCHAR FileList[MAXFILENUM][MAX_PATH]; //文件名列表 
                                                                          //(注：當(dāng)nFileNum = 0 時(shí)，此數(shù)組中的內(nèi)容無效)
      }FILELIST;

      （4）bool GetFile( LPCTSTR lpszLocalFile, LPCTSTR lpszRemoteFile,
                                   int nMode = 0, bool bResume=FALSE );
      功能描述：從FTP服務(wù)器上下載指定文件（如果下載的文件已存在于本地當(dāng)前目錄下，將覆蓋下載）
       輸入?yún)��?shù) lpszLocalFile：存儲(chǔ)為本地文件名
      lpszRemoteFile：下載的指定文件
      nMode:傳輸模式  =0: 二進(jìn)制模式 =1: 文本模式
      bResume:斷點(diǎn)續(xù)傳標(biāo)志
      =TRUE：繼點(diǎn)續(xù)傳
      （程序?qū)�掛斷FTP連接，重新執(zhí)行Logon(),ChangeDir()，然后下載）
      =FALSE: 正常下載
      返回值 =  TRUE：開始下載  
      FALSE：開始下載失敗

      （5）bool DelFile( LPCTSTR lpszFileName)
      功能描述：刪除遠(yuǎn)端FTP服務(wù)器當(dāng)前目錄下指定文件
      輸入?yún)��?shù) lpszFileName：指定要?jiǎng)h除的文件
      返回值 =  TRUE：刪除成功  
      FALSE：刪除失敗

      （6）bool Logoff( );
       功能描述：注銷與遠(yuǎn)端FTP服務(wù)器的連接

      （7）void Abort( );
      功能描述：中斷與遠(yuǎn)端FTP服務(wù)器的連接

      （8）FTPSTATUS* GetStatus( );
      功能描述：獲取當(dāng)前文件的下載狀態(tài)
      返回值： 指向當(dāng)前下載文件狀態(tài)數(shù)據(jù)結(jié)構(gòu)的指針
      文件下載狀態(tài)數(shù)據(jù)結(jié)構(gòu)定義如下：
      typedef struct  
      {
      int  nSucceed;    //上傳/下載是否成功
                               //=0：文件正在傳輸，=1文件傳輸成功，=-1文件傳輸失敗
      int  nErrCnt;     //重傳次數(shù)
      int  nMode;     //上傳=1，下載=2
      int  nStatus;     // FTP狀態(tài)
      DWORD dwFileSize;    //文件字節(jié)數(shù)
      DWORD dwCompleteSize; // 已完成字節(jié)數(shù)
      }FTPSTATUS;

      （9）int  GetErrorCode( );
      功能描述：獲取最后一次錯(cuò)誤的錯(cuò)誤碼
      返回值：錯(cuò)誤碼（錯(cuò)誤碼的定義請(qǐng)參看EM_FTPClient.H）

      補(bǔ)充說明：

      1、在調(diào)用GetFile（）函數(shù)時(shí)，如果將bResum設(shè)置為TRUE，程序?qū)⒆詣?dòng)執(zhí)行以下步驟：
      ↓調(diào)用Abort( )中斷與FTP服務(wù)器的連接
      ↓調(diào)用Logon( )登錄到FTP服務(wù)器
      ↓調(diào)用ChangeDir( )設(shè)置FTP服務(wù)器當(dāng)前目錄
      ↓從已完成傳送的部份繼續(xù)下載
      其中Logon()和ChangeDir( )的參數(shù)是最后一次調(diào)用Logon()和ChangeDir( )傳入的值。

      2、調(diào)用GetFile（）函數(shù)返回為TRUE時(shí)，并不是表示文件下載成功，只表明文件開始下載。主程序應(yīng)該通過判斷FTPSTATUS數(shù)據(jù)結(jié)構(gòu)中的nSucceed值來確認(rèn)下載是否成功。

      3、現(xiàn)在的FTP服務(wù)器普遍支持PASV模式，因此本FTP Client僅支持PASV模式數(shù)據(jù)傳送。

      4、英創(chuàng)公司提供相應(yīng)的測試?yán)�程，感興趣的客戶可向英創(chuàng)索要相關(guān)代碼。