文件傳送協(xié)議(FTP — File Transfer Protocol)是TCP/IP提供的標(biāo)準(zhǔn)機(jī)制,用來從一臺主機(jī)將文件復(fù)制到另一臺主機(jī)。從一臺計(jì)算機(jī)向另一臺計(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自動更新》中介紹的方案,就是利用WinCE內(nèi)核提供的FTP Server實(shí)現(xiàn)的應(yīng)用程序遠(yuǎn)程更新。但在很多應(yīng)用場合,是工控主板作為本地FTP客戶端與遠(yuǎn)端FTP服務(wù)器交換文件,為此需要程序員自己編寫在ARM9主板上運(yùn)行的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文件傳送具有斷點(diǎn)續(xù)傳功能。 斷點(diǎn)續(xù)傳是指在文件的傳送過程中,因?yàn)榫W(wǎng)絡(luò)或其它原因至使傳送過程中斷,當(dāng)再次傳送這個文件時,將從已傳送的部份開始,繼續(xù)未完成部份傳送,不用從頭對整個文件進(jìn)行傳送,這樣可以節(jié)省時間,節(jié)約網(wǎng)絡(luò)流量,提高文件傳送速度。對于在GPRS網(wǎng)絡(luò)上應(yīng)用的FTP,斷點(diǎn)續(xù)傳功能顯得尤為重要,但Microsoft提供的FTP API中,卻沒有支持?jǐn)帱c(diǎn)續(xù)傳的函數(shù),為此,英創(chuàng)公司針對斷點(diǎn)續(xù)傳這一要求,直接采用SOCKET API,封裝了一個支持?jǐn)帱c(diǎn)續(xù)傳的FTP客戶端靜態(tài)庫EM_FTPClient.LIB,下面對這個庫函的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)用戶名用與用戶密碼為空時,將匿名登錄) 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: 二進(jìn)制模式 =1: 文本模式 bResume:斷點(diǎn)續(xù)傳標(biāo)志 =TRUE:繼點(diǎn)續(xù)傳 (程序?qū)鞌郌TP連接,重新執(zhí)行Logon(),ChangeDir(),然后下載)