用SHGetFileInfo函数获取文件信息

原创已于 2022-10-12 17:15:04 修改 · 1.7k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#安全 #c++ #windows

于 2020-06-05 17:52:52 首次发布

VC+Window系统管理专栏收录该内容

20 篇文章

订阅专栏

本文深入探讨了Windows系统API SHGetFileInfo的使用，包括其定义、参数说明以及如何获取文件的图标、显示名、类型名等信息。通过示例代码展示了如何获取不同大小的图标，以及如何获取特定文件类型的图标。此外，还提到了SHGetFileInfo在获取特殊文件夹如‘此电脑’或‘回收站’文字时的作用。

Windows系统的shallapi函数

SHGetFileInfo函数

WINSHELLAPI DWORD WINAPI SHGetFileInfo(
LPCTSTR pszPath,
DWORD dwFileAttributes,
SHFILEINFO FAR *psfi,
UINT cbFileInfo,
UINT uFlags
);

SHGetFileInfo的定义

MSDN上的定义是：

Retrieves information about an object in the file system, such as a file, folder, directory, or drive root.

它在shellapi.h中定义，需要包含头文件#include <shellapi.h>

SHGetFileInfo()函数提供关于文件系统对象的信息。这个对象可以是文件，文件夹，目录或驱动器根。返回值代表相当多的返回状态，这与uFlags参数的设置有关。使用这个函数，可以期望：

确定可执行文件的目标平台(x64, Win32，Win16，MS-DOS)
获取各种有特色的文件图标(小的，大的，有关联重叠的，选中的，打开的)
读出其它显示属性，如文件类型(显示在探测器类型列上的简短描述)和显示名(出现在名字列上)
读出任何其它属性，可以是文件特有的，如，是否可以拷贝，移动，删除或重命名，是否它可以形成一个快捷方式，它是否有子文件夹，是否是共享的，是拖拽目标，或有附加的属性页，等等。

应该注意的是，

在调用SHGetFileInfo()之前，必须使用 CoInitialize 或者OleInitialize 初始化COM，否则表面上能够使用，但是会造成不安全或者丧失部分功能。例如：如果不初始化COM，那么调用该函数就无法得到.htm/.mht/.xml文件的图标。

参数说明

WINSHELLAPI DWORD WINAPI SHGetFileInfo(
LPCTSTR pszPath,
DWORD dwFileAttributes,
SHFILEINFO FAR *psfi,
UINT cbFileInfo,
UINT uFlags
);

pszPath 一个包含要取得信息的文件相对或绝对路径的缓冲。它可以处理长或短文件名。（也就是指定的文件路径）注[1]

dwFileAttributes 资料上说，这个参数仅用于uFlags中包含SHGFI_USEFILEATTRIBUTES标志的情况(一般不使用)。如此，它应该是文件属性的组合：存档，只读，目录，系统等。

Psfi 指向一个接收数据的SHFILEINFO结构的指针。注[2]

cbFileInfo 简单地给出上项结构的尺寸。

uFlags 函数的核心变量，通过所有可能的标志，你就能驾驭函数的行为和实际地得到信息。

详细说明：

pszPath 参数:指定的文件名。
当uFlags的取值中不包含 SHGFI_PIDL时,可直接指定;
当uFlags的取值中包含 SHGFI_PIDL时pszPath要通过计算获得,不能直接指定;

dwFileAttributes参数:文件属性。
仅当uFlags的取值中包含SHGFI_USEFILEATTRIBUTES时有效，一般不用此参数;

psfi 参数:返回获得的文件信息，是一个记录类型，有以下字段:

hIcon: HICON;                      { out: icon }  //文件的图标句柄
iIcon: Integer;                    { out: icon index }     //图标的系统索引号
dwAttributes: DWORD;               { out: SFGAO_ flags }    //文件的属性值
szDisplayName: array [0..MAX_PATH-1] of  AnsiChar; { out: display name (or path) }  //文件的显示名
szTypeName: array [0..79] of AnsiChar;             { out: type name }      //文件的类型名

typedef struct _SHFILEINFOW
{
HICON hIcon; // out: icon
int iIcon; // out: icon index
DWORD dwAttributes; // out: SFGAO_ flags
WCHAR szDisplayName[MAX_PATH]; // out: display name (or path)
WCHAR szTypeName[80]; // out: type name
} SHFILEINFOW;

cbFileInfo 参数:psfi的比特值;

uFlags 参数:指明需要返回的文件信息标识符,常用的有以下常数:
SHGFI_ICON;           //获得图标
SHGFI_DISPLAYNAME;    //获得显示名
SHGFI_TYPENAME;       //获得类型名
SHGFI_ATTRIBUTES;     //获得属性
SHGFI_LARGEICON;      //获得大图标
SHGFI_SMALLICON;      //获得小图标
SHGFI_PIDL;           // pszPath是一个标识符

函数SHGetFileInfo()的返回值随uFlags的取值变化而有所不同。

调用SHGetFileInfo()可以由psfi参数得到文件的图标句柄。但要注意在uFlags参数中不使用SHGFI_PIDL时，SHGetFileInfo()不能获得“我的电脑”等虚似文件夹的信息。

获得系统图标列表：

//小图标
ImageListHandle := SHGetFileInfo('C:/',
                           0,
                           FileInfo,
                           SizeOf(FileInfo),
                           SHGFI_SYSICONINDEX or SHGFI_SMALLICON);
//把图标列表同一个名叫ListView1的ListView控件的小图标关联。
SendMessage(ListView1.Handle, LVM_SETIMAGELIST, LVSIL_SMALL, ImageListHandle);

//大图标
ImageListHandle := SHGetFileInfo('C:/',
                           0,
                           FileInfo,
                           SizeOf(FileInfo),
                           SHGFI_SYSICONINDEX or SHGFI_LARGEICON);

//把图标列表同一个名叫ListView1的ListView控件的大图标关联。
SendMessage(ListView1.Handle, LVM_SETIMAGELIST, LVSIL_NORMAL, ImageListHandle);

获得一个文件的显示名和图标

//取图标的索引号等信息
SHGetFileInfo(PAnsiChar(FileName),
                0,
                sfi,
                sizeof(TSHFileInfo),
                ShellAPI.SHGFI_DISPLAYNAME or ShellAPI.SHGFI_TYPENAME or ShellAPI.SHGFI_LARGEICON or ShellAPI.SHGFI_ICON);
//显示名和图标在系统图标列表中的编号就分别在sfi.szDisplayName和sfi.iIcon中

从PE文件中提取icon资源

对于EXE文件，最简单的是使用SHGetFileInfo API，但只能获取16* 16，32 * 32 size的图标。该api如果只指定SHGFI_ICON，则表明使用默认的32*32，如果指定SHGFI_LARGEICON，则表明是32*32，如果指定SHGFI_SMALLICON，则表明是16*16。SHGetFileInfo 还可以根据文件后缀名获取某类文件的图标。
示例代码：
1、某文件的32 * 32 pixels icon

//获取exe的32 * 32 icon
SHFILEINFO sfi;
ZeroMemory(&sfi, sizeof(SHFILEINFO));
::SHGetFileInfo(L"D:\\a.exe", FILE_ATTRIBUTE_NORMAL, &sfi, sizeof(SHFILEINFO), SHGFI_ICON | SHGFI_LARGEICON);
HICON icon_handle = sfi.hIcon;
2、某类文件的32 * 32 pixels icon

//获取*.rmvb文件类型的32 * 32 icon
SHFILEINFO sfi;
ZeroMemory(&sfi, sizeof(SHFILEINFO));
::SHGetFileInfo(L"*.rmvb", FILE_ATTRIBUTE_NORMAL, &sfi, sizeof(SHFILEINFO), SHGFI_ICON | SHGFI_USEFILEATTRIBUTES);
HICON icon_handle = sfi.hIcon;

3、提取其它size的图标，譬如: 48 * 48、256 * 256
//获取48 * 48 或者 256 * 256 pixels icon
SHFILEINFO sfi;
ZeroMemory(&sfi, sizeof(SHFILEINFO));
::SHGetFileInfo(L"D:\\b.exe", FILE_ATTRIBUTE_NORMAL, &sfi, sizeof(SHFILEINFO), SHGFI_SYSICONINDEX);
HIMAGELIST* imageList = NULL;
//SHIL_EXTRALARGE获取48 * 48的图标， SHIL_JUMBO 获取256 * 256的图标。
HRESULT hResult = ::SHGetImageList(SHIL_EXTRALARGE , IID_IImageList, (void**)&imageList);
HICON icon_handle = NULL;
if (hResult == S_OK)
{
hResult = ((IImageList*)imageList)->GetIcon(sfi.iIcon, ILD_NORMAL, &icon_handle);
}

获取此电脑或回收站的文字

#include <iostream>
#include <Windows.h>
#include <ShlObj.h>

#pragma comment(lib, "shell32.lib")

using namespace std;
int main()
{
std::cout << "Hello World!\n";

CHAR szDir[MAX_PATH] = { 0 };
LPITEMIDLIST pidl = NULL;
//DWORD hr = SHGetSpecialFolderLocation(NULL, CSIDL_COMMON_ALTSTARTUP, &pidl);
//SHGetPathFromIDListA(pidl, szDir); // szDir得到STARTUP的路径
//cout << szDir << endl;

//CSIDL_BITBUCKET 获取回收站的文字

DWORD hr = SHGetFolderLocation(NULL, CSIDL_DRIVES, NULL, 0, &pidl);

if (SUCCEEDED(hr))
{
SHFILEINFOW sfi = { 0 };
hr = SHGetFileInfo((LPCTSTR)pidl,
-1,
&sfi,
sizeof(sfi),
SHGFI_PIDL | SHGFI_DISPLAYNAME);

if(SUCCEEDED(hr))
{
std::wstring strName = sfi.szDisplayName;
std::wstring strTypeName = sfi.szTypeName;
wcout << L"strName11 = " << strName << L" info.szTypeName =" << strTypeName << endl;
}
else {
wcout << "error11 " << endl;
}
}

ILFree(pidl);

system("pause");
return 0;

}