CFileFind類的使用總結
2007-7-7
1、CFileFind類的聲明文件保存在afx.h頭文件中。
2、該類的實現的功能：執行本地文件的查找(查找某個具體的文件，查找某類文件x*.x*，查找所有文件*.*)
3、CFileFind類是CGopherFileFind和CFtpFileFind類的基類。
4、CFileFind類的構造函數::CFileFind()和關閉函數::Close()我會成對使用。
5、CFileFind類的成員函數我根據其操作特性劃分爲３類：查找操作類、獲得文件屬性類、判斷文件屬性類。(下面我先進行函數羅列並沒有完整的描述函數的參數)
查找操作類
::FindFile();
::FindNextFile();
獲得文件屬性類
::GetCreationTime();
::GetLastAccessTime();
::GetLastWriteTime();
::GetFileName();
::GetRoot();
::GetFilePath();
::GetFileTitle();
::GetFileURL();
::GetLength();
判斷文件屬性類
::IsArchived();
::IsCompressed();
::IsDirectory();
::IsDots();
::IsHidden();
::IsNormal();
::IsReadOnly();
::IsSystem();
::IsTemporary();
::MatchesMask();
6、CFileFind類中成員函數使用應注意的順序
在創建了CFileFind對象後，先執行::FindFile()函數，然後執行::FindNextFile()，然後選擇執行（獲得文件屬性類）的函數或者（判斷文件屬性類）函數。
7、CFileFind類成員函數的詳細分析
virtual BOOL FindFile(LPCTSTR pstrName = null,DWORD dwUnused = 0);
該函數若返回非0 則表明執行成功，0 則表明執行不成功。
pstrName：需要查找的文件名，例：“E://編程工具//VC++//MFC例子.rar”，“E://編程工具//VC++//MFC*.rar”，“E://編程工具//VC++//*.*”，也可以是NULL表示“*.*”。
dwUnused：必須爲0
virtual BOOL FindNextFile();
該函數返回值非0 還有符合條件的文件， 0表示是最後一個文件。
virtual BOOL GetCreationTime(FILETIME *pFileTime) const;
virtual BOOL GetCreationTime(CTime& refTime) const;
該函數用來獲得查找到的某個文件的創建時間，返回值非0 獲得創建時間成功操作，0表示執行獲得創建時間失敗或者FindNextFile()沒有被執行的時候。
FILETIME *：容納時間的結構指針
CTime&：容納時間的對象地址
此處介紹：FILETIME和CTime相互轉換的處理方法：
FILETIME轉CTime的方法：
A、CTime對象在初始化時可以傳遞FILETIME結構
FILETIME ft；
CTime time(ft)；
B、將FILETIME轉換爲SYSTEMTIME，然後CTime對象在初始化時可以傳遞SYSTEMTIME結構
FILETIME ft；
SYSTEMTIME st；
BOOL bSuccess ＝ ::FileTimeToSystemTime(&ft , &st);
CTime time(st)；
CTime轉FILETIME方法：
CTime time(CTime::GetCurrentTime());
SYSTEMTIME st;
time.GetAsSystemTime(st);
FILETIME ft;
::SystemTimeToFileTime(&st,&ft);
virtual BOOL GetLastAccessTime(FILETIME *pFileTime) const;
virtual BOOL GetLastAccessTime(CTime& refTime) const;
該函數用來獲得某個文件最後被訪問的時間，非0表示執行成功，0表示執行失敗或者FindNextFile()函數沒有執行的時候。
virtual BOOL GetLastWriteTime(FILETIME *pFileTime) const;
virtual BOOL GetLastWriteTime(CTime& refTime) const;
該函數用來獲得某個文件最後被訪問的時間，非0表示執行成功，0表示執行失敗或者FindNextFile()函數沒有執行的時候。
virtual CString GetFilePath() const;
該函數用來獲得查找到的文件絕對路徑，必須在執行了FindNextFile()後該函數才能執行成功。
返回的結果是CString對象，例“E://編程工具//VC++//MFC.rar”
virtual CString GetFileName() const;
該函數用來獲得查找到的文件的全稱，必須在執行了FindNextFile()後該函數才能執行成功。
返回的結果是CString對象，例“MFC.rar”
virtual CString GetFileTitle() const;
該函數用來獲得查找到的文件的名稱，必須在執行了FindNextFile()後該函數才能執行成功。
返回的結果是CString對象，例“MFC”
virtual CString GetRoot() const;
該函數用來獲得查找到的文件的根目錄，必須在執行了FindNextFile()後該函數才能執行成功。
返回的結果是CString對象，例“E://編程工具//VC++//”
virtual CString GetFileURL() const;
該函數用來獲得查找到的文件的URL路徑，必須在執行了FindNextFile()後該函數才能執行成功。
返回的結果是CString對象，例“file://E://編程工具//VC++//MFC.rar”
DWORD GetLength() const;
該函數返回值獲得查找到的文件的長度，必須在執行了FindNextFile()後該函數才能執行成功。
BOOL IsArchived() const;
該函數用來判斷查找的文件屬性是否是檔案文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsCompressed() const;
該函數用來判斷查找的文件屬性是否是壓縮文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsDirectory() const;
該函數用來判斷查找的文件屬性是否是路徑文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsDots() const;
該函數用來判斷查找的文件屬性是否是“.”，“..”，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsHidden() const;
該函數用來判斷查找的文件屬性是否隱藏文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsNormal() const;
該函數用來判斷查找的文件屬性是否正常文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsReadOnly() const;
該函數用來判斷查找的文件屬性是否只讀文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsSystem() const;
該函數用來判斷查找的文件屬性是否系統文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL IsTemporary() const;
該函數用來判斷查找的文件屬性是否臨時文件，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
BOOL MatchesMask(DWORD dwMask) const;
該函數用來判斷查找的文件的綜合屬性，非0表示是，0表示不是。必須在執行了FindNextFile()後該函數才能執行成功
dwMask參數的使用方法：幾種文件屬性採用或運算（|）
文件屬性的結構定義：
FILE_ATTRIBUTE_ARCHIVE：檔案文件
FILE_ATTRIBUTE_COMPRESSED：壓縮文件
FILE_ATTRIBUTE_DIRECTORY：路徑文件
FILE_ATTRIBUTE_NORMAL：正常文件
FILE_ATTRIBUTE_READONLY：只讀文件
FILE_ATTRIBUTE_SYSTEM：系統文件
FILE_ATTRIBUTE_TEMPORARY：臨時文件
FILE_ATTRIBUTE_HIDDEN：隱藏文件
