文件傳送協(xié)議(FTP — File Transfer Protocol)是TCP/IP提供的標(biāo)準(zhǔn)機制,用來從一臺主機將文件復(fù)制到另一臺主機。從一臺計算機向另一臺計算機傳送文件是在聯(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實現(xiàn)文件傳送提供了方便,在本公司網(wǎng)站文章 《ARM9工控主板WinCE應(yīng)用程序的遠(yuǎn)程FTP自動更新》 中介紹的方案,就是利用WinCE內(nèi)核提供的FTP Server實現(xiàn)的應(yīng)用程序遠(yuǎn)程更新。但在很多應(yīng)用場合,是工控主板作為本地FTP客戶端與遠(yuǎn)端FTP服務(wù)器交換文件,為此需要程序員自己編寫在ARM9主板上運行的FTP客戶端的程序。對于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ò)連接很容易中斷,如果每次連接中斷,整個文件都重新傳送,一個稍大的文件基本上不能成功傳送,此時就要求FTP文件傳送具有斷點續(xù)傳功能。 斷點續(xù)傳是指在文件的傳送過程中,因為網(wǎng)絡(luò)或其它原因至使傳送過程中斷,當(dāng)再次傳送這個文件時,將從已傳送的部份開始,繼續(xù)未完成部份傳送,不用從頭對整個文件進行傳送,這樣可以節(jié)省時間,節(jié)約網(wǎng)絡(luò)流量,提高文件傳送速度。對于在GPRS網(wǎng)絡(luò)上應(yīng)用的FTP,斷點續(xù)傳功能顯得尤為重要,但Microsoft提供的FTP API中,卻沒有支持?jǐn)帱c續(xù)傳的函數(shù),為此,英創(chuàng)公司針對斷點續(xù)傳這一要求,直接采用SOCKET API,封裝了一個支持?jǐn)帱c續(xù)傳的FTP客戶端靜態(tài)庫EM_FTPClient.LIB,下面對這個庫函的API函數(shù)做詳細(xì)說明。 支持?jǐn)帱c續(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)用戶名用與用戶密碼為空時,將匿名登錄) nTimeOut:超時設(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)前目錄文件個數(shù) TCHAR FileList[MAXFILENUM][MAX_PATH]; //文件名列表 //(注:當(dāng)nFileNum = 0 時,此數(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:存儲為本地文件名 lpszRemoteFile:下載的指定文件 nMode:傳輸模式 =0: 二進制模式 =1: 文本模式 bResume:斷點續(xù)傳標(biāo)志 =TRUE:繼點續(xù)傳 (程序?qū)鞌郌TP連接,重新執(zhí)行Logon(),ChangeDir(),然后下載) =FALSE: 正常下載 返回值 = TRUE:開始下載 FALSE:開始下載失敗 (5)bool DelFile( LPCTSTR lpszFileName) 功能描述:刪除遠(yuǎn)端FTP服務(wù)器當(dāng)前目錄下指定文件 輸入?yún)?shù) lpszFileName:指定要刪除的文件 返回值 = 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( ); 功能描述:獲取最后一次錯誤的錯誤碼 返回值:錯誤碼(錯誤碼的定義請參看EM_FTPClient.H) 補充說明: 1、在調(diào)用GetFile()函數(shù)時,如果將bResum設(shè)置為TRUE,程序?qū)⒆詣訄?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時,并不是表示文件下載成功,只表明文件開始下載。主程序應(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)代碼。