本文从一下几个方法进行介绍:
SHGetFileInfo在MSDN上的定义是:
Retrieves information about an object in the file system, such as a file, folder, directory, or drive root.它在 shellapi.h中定义。这个函数有五个变量,定义如下:
DWORD_PTR SHGetFileInfo( __in LPCTSTR pszPath, DWORD dwFileAttributes, __inout SHFILEINFO *psfi, UINT cbFileInfo, UINT uFlags );
基本上讲,SHGetFileInfo()函数提供关于文件系统对象的信息。如前面解释的,这个对象可以是文件,文件夹,目录或驱动器根。DWORD的返回是指可能有相当多的返回状态,这与uFlags变量的设置有关。简单地说,使用这个函数,你可以期望:
为了正确地理解函数具有的功能,使用所有可能的方法强制调用这个函数是十分必要的。首先,让我们查看一下他所要求的变量:
变量名 |
描述 |
pszPath |
一个包含要取得信息的文件相对或绝对路径的缓冲。它可以处理长或短文件名。(也就是指定的文件路径)注[1] |
dwFileAttributes |
资料上说,这个参数仅用于uFlags中包含SHGFI_USEFILEATTRIBUTES标志的情况(一般不使用)。如此,它应该是文件属性的组合:存档,只读,目录,系统等。 |
Psfi |
指向一个接收数据的SHFILEINFO结构的指针。注[2] |
cbFileInfo |
简单地给出上项结构的尺寸。 |
uFlags |
函数的核心变量,通过所有可能的标志,你就能驾驭函数的行为和实际地得到信息。 |
注[1]:当uFlags的取值中不包含 SHGFI_PIDL时,可直接指定;
当uFlags的取值中包含 SHGFI_PIDL时pszPath要通过计算获得,不能直接指定; 注[2]:SHFILEINFO结构定义如下:
typedef struct _SHFILEINFO { HICON hIcon; int iIcon; DWORD dwAttributes; TCHAR szDisplayName[MAX_PATH]; TCHAR szTypeName[80]; } SHFILEINFO;此外,这个结构总是用于返回数据到调用程序,并且从不需要初始化。唯一可以包含信息来影响函数行为的是dwAttributes成员,在后面将进一步给出解释。显然,使用SHGetFileInfo()函数各种行为的所有兴趣都集中在对uFlags变量值的设置上。绝大多数情况下,信息经由psfi缓冲返回,但也有些情况,可以有效地包含在函数的DWORD返回之中。
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 |
如果函数返回0,则某个地方发生了错误。在大多数情况下,是因为传递了不合理的文件名或PIDL,或指定了矛盾的标志组合。与前两个相比,后面一个更有可能。 除非指定的标志告诉它做指定的操作,如果每一个操作都顺利完成,这个函数返回1。一个例外是,当SHGFI_EXETYPE标志设置的时候,
SHGetFileInfo()返回DWORD值,此时低字表示可执行文件的签名,下面表中给出解释:
文件签名 |
Hex码 |
意义 |
PE |
0x4550 |
Win32可执行格式,由微软所有32位操作系统采用。 |
NE |
0x454E |
Windows 3.x新的可执行格式,典型地16位窗口程序 |
MZ |
0x5A4D |
DOS 可执行格式,如果查询.com 或 .bat也返回这个值。 |
对应的Hex码实际是文件签名列的字符码。例如 0x50 对应 P ,0x45 对应 E 等。 高位字的两个字节包含了运行要求的最小操作系统版本号。
另一个使返回码包含更多意义的情况是SHGFI_SYSICONINDEX标志被设置。此时,函数返回一个系统图像列表Handle,它包含了指定文件或文件夹的图标。
#include <windows.h> #include <ShellAPI.h> #include <ShlObj.h> int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow) { TCHAR str[MAX_PATH] = {0}; OPENFILENAME ofn; ZeroMemory(&ofn,sizeof(OPENFILENAME)); ofn.lStructSize = sizeof(OPENFILENAME); ofn.lpstrFilter = TEXT("All File\0*.*\0Text\0*.txt\0\0"); ofn.nFilterIndex = 1; ofn.lpstrFile = str; ofn.nMaxFile = MAX_PATH; ofn.lpstrInitialDir = TEXT("C:\\"); ofn.lpstrTitle = TEXT("Hello"); if(GetOpenFileName(&ofn)) //LPITEMIDLIST pidl = NULL; //SHGetFolderLocation(NULL, CSIDL_DRIVES, NULL, 0, &pidl); { CoInitialize(NULL); SHFILEINFO shfi; ZeroMemory(&shfi, sizeof(SHFILEINFO)); HRESULT hr = SHGetFileInfo((LPCTSTR)ofn.lpstrFile, -1, &shfi, sizeof(shfi), SHGFI_DISPLAYNAME | SHGFI_TYPENAME | SHGFI_ATTRIBUTES); if (SUCCEEDED(hr)) { // The display name is now held in sfi.szDisplayName. DWORD dwAttr = shfi.dwAttributes; TCHAR sbuf[1024] = {0}; if (dwAttr & SFGAO_CANCOPY) lstrcat(sbuf,TEXT("Copy, ")); if(dwAttr & SFGAO_CANDELETE) lstrcat(sbuf,TEXT("Delete, ")); if(dwAttr & SFGAO_CANMOVE) lstrcat(sbuf,TEXT("Move, ")); if(dwAttr & SFGAO_CANRENAME) lstrcat(sbuf,TEXT("Rename, ")); if(dwAttr & SFGAO_CANLINK) lstrcat(sbuf,TEXT("Link, ")); wsprintf(str,TEXT("the display name is:%s\nthe typename is:%s\nthe attribute is %s\nthe icon index is %d\n"), shfi.szDisplayName,shfi.szTypeName,sbuf,shfi.iIcon); MessageBox(NULL,str,TEXT("MessageBox"),MB_OK); } CoUninitialize(); } return 0; }