多個(gè)方法實(shí)現(xiàn)：Windows API——SHGetFileInfo——獲取文件信息
本文從一下幾個(gè)方法進(jìn)行介紹：
?
?SHGetFileInfo的定義 ?SHGetFileInfo()函數(shù)的工作原理 ?SHGetFileInfo()函數(shù)的返回值 ?SHGetFileInfo()函數(shù)的簡(jiǎn)單示例
?
?SHGetFileInfo的定義
? ? ? ?SHGetFileInfo在MSDN上的定義是：
?Retrieves?information?about?an?object?in?the?file?system,???
such?as?a?file,?folder,?directory,?or?drive?root.???
? ? ? ?它在shellapi.h中定義。這個(gè)函數(shù)有五個(gè)變量，定義如下：
DWORD_PTR SHGetFileInfo(
? __in???? LPCTSTR pszPath,
? DWORD dwFileAttributes,
? __inout? SHFILEINFO *psfi,
? UINT cbFileInfo,
? UINT uFlags
);
? ? ? ?基本上講，SHGetFileInfo()函數(shù)提供關(guān)于文件系統(tǒng)對(duì)象的信息。如前面解釋的，這個(gè)對(duì)象可以是文件，文件夾，目錄或驅(qū)動(dòng)器根。DWORD的返回是指可能有相當(dāng)多的返回狀態(tài)，這與uFlags變量的設(shè)置有關(guān)。簡(jiǎn)單地說，使用這個(gè)函數(shù)，你可以期望：
確定可執(zhí)行文件的目標(biāo)平臺(tái)(Win32，Win16，MS-DOS) 獲取各種有特色的文件圖標(biāo)(小的，大的，有關(guān)聯(lián)重疊的，選中的，打開的) 讀出其它顯示屬性，如文件類型(顯示在探測(cè)器類型列上的簡(jiǎn)短描述)和顯示名(出現(xiàn)在名字列上) 讀出任何其它屬性，可以是文件特有的，如，是否可以拷貝，移動(dòng)，刪除或重命名，是否它可以形成一個(gè)快捷方式，它是否有子文件夾，是否是共享的，是拖拽目標(biāo)，或有附加的屬性頁，等等。 ? ? ?注：應(yīng)該注意的是，在調(diào)用SHGetFileInfo()之前，必須使用 CoInitialize 或者OleInitialize 初始化COM,否則表面上能夠使用，但是會(huì)造成不安全或者喪失部分功能。 SHGetFileInfo()函數(shù)的工作原理
???????為了正確地理解函數(shù)具有的功能，使用所有可能的方法強(qiáng)制調(diào)用這個(gè)函數(shù)是十分必要的。首先，讓我們查看一下他所要求的變量：
變量名
描述
pszPath
一個(gè)包含要取得信息的文件相對(duì)或絕對(duì)路徑的緩沖。它可以處理長(zhǎng)或短文件名。（也就是指定的文件路徑）注[1]
dwFileAttributes
資料上說，這個(gè)參數(shù)僅用于uFlags中包含SHGFI_USEFILEATTRIBUTES標(biāo)志的情況(一般不使用)。如此，它應(yīng)該是文件屬性的組合：存檔，只讀，目錄，系統(tǒng)等。
Psfi
指向一個(gè)接收數(shù)據(jù)的SHFILEINFO結(jié)構(gòu)的指針。注[2]
cbFileInfo
簡(jiǎn)單地給出上項(xiàng)結(jié)構(gòu)的尺寸。
uFlags
函數(shù)的核心變量，通過所有可能的標(biāo)志，你就能駕馭函數(shù)的行為和實(shí)際地得到信息。
?注[1]:當(dāng)uFlags的取值中不包含 SHGFI_PIDL時(shí),可直接指定;
? 當(dāng)uFlags的取值中包含 SHGFI_PIDL時(shí)pszPath要通過計(jì)算獲得,不能直接指定;??
?
uFlags 參數(shù):指明需要返回的文件信息標(biāo)識(shí)符,常用的有以下常數(shù):
??? SHGFI_ICON;?????????? //獲得圖標(biāo)
??? SHGFI_DISPLAYNAME;??? //獲得顯示名
??? SHGFI_TYPENAME;?????? //獲得類型名
??? SHGFI_ATTRIBUTES;???? //獲得屬性
??? SHGFI_LARGEICON;????? //獲得大圖標(biāo)
??? SHGFI_SMALLICON;????? //獲得小圖標(biāo)
??? SHGFI_PIDL;?????????? // pszPath是一個(gè)標(biāo)識(shí)符
函數(shù)SHGetFileInfo()的返回值也隨uFlags的取值變化而有所不同。
?
可見通過調(diào)用SHGetFileInfo()可以由psfi參數(shù)得到文件的圖標(biāo)句柄。但要注意在uFlags參數(shù)中不使用SHGFI_PIDL時(shí),SHGetFileInfo()不能獲得“我的電腦”等虛似文件夾的信息。
?
?注[2]:SHFILEINFO結(jié)構(gòu)定義如下：
typedef?struct?_SHFILEINFO?{??
HICON?hIcon;??//文件的圖標(biāo)句柄
int???iIcon;??//圖標(biāo)的系統(tǒng)索引號(hào)
DWORD?dwAttributes;??//文件的屬性值
TCHAR?szDisplayName[MAX_PATH];?//文件的顯示名?
TCHAR?szTypeName[80];??//文件的類型名
}?SHFILEINFO;??
??????? 此外，這個(gè)結(jié)構(gòu)總是用于返回?cái)?shù)據(jù)到調(diào)用程序，并且從不需要初始化。唯一可以包含信息來影響函數(shù)行為的是dwAttributes成員，在后面將進(jìn)一步給出解釋。顯然，使用SHGetFileInfo()函數(shù)各種行為的所有興趣都集中在對(duì)uFlags變量值的設(shè)置上。絕大多數(shù)情況下，信息經(jīng)由psfi緩沖返回，但也有些情況，可以有效地包含在函數(shù)的DWORD返回之中。 ?SHGetFileInfo()函數(shù)的返回值
?
Returns?a?value?whose?meaning?depends?on?the?uFlags?parameter.??? If?uFlags?contains?the?SHGFI_EXETYPE?flag,?the?return?value?specifies?? the?type?of?the?executable?file.?It?will?be?one?of?the?following?values:??? Value Executable File Type 0 Nonexecutable file or an error condition LOWORD = NE or PE and HIWORD = 3.0, 3.5, or 4.0 Windows application LOWORD = MZ and HIWORD = 0 MS-DOS .exe, .com, or .bat file LOWORD = PE and HIWORD = 0 Win32 console application
?
? ? ? ?如果函數(shù)返回0，則某個(gè)地方發(fā)生了錯(cuò)誤。在大多數(shù)情況下，是因?yàn)閭鬟f了不合理的文件名或PIDL，或指定了矛盾的標(biāo)志組合。與前兩個(gè)相比，后面一個(gè)更有可能。?除非指定的標(biāo)志告訴它做指定的操作，如果每一個(gè)操作都順利完成，這個(gè)函數(shù)返回1。一個(gè)例外是，當(dāng)SHGFI_EXETYPE標(biāo)志設(shè)置的時(shí)候，
? ? ? SHGetFileInfo()返回DWORD值，此時(shí)低字表示可執(zhí)行文件的簽名，下面表中給出解釋：
文件簽名
Hex碼
意義
PE
0x4550
Win32可執(zhí)行格式，由微軟所有32位操作系統(tǒng)采用。
NE
0x454E
Windows 3.x新的可執(zhí)行格式，典型地16位窗口程序
MZ
0x5A4D
DOS?可執(zhí)行格式，如果查詢．com?或?．bat也返回這個(gè)值。
對(duì)應(yīng)的Hex碼實(shí)際是文件簽名列的字符碼。例如?0x50?對(duì)應(yīng)?P?，0x45?對(duì)應(yīng)?E?等。?高位字的兩個(gè)字節(jié)包含了運(yùn)行要求的最小操作系統(tǒng)版本號(hào)。
?
? ? ? ? 另一個(gè)使返回碼包含更多意義的情況是SHGFI_SYSICONINDEX標(biāo)志被設(shè)置。此時(shí)，函數(shù)返回一個(gè)系統(tǒng)圖像列表Handle，它包含了指定文件或文件夾的圖標(biāo)。
?SHGetFileInfo()函數(shù)的簡(jiǎn)單示例
?
?
下載文檔
