WINDOWS API——SHGETFILEINFO——获取文件信息

最新推荐文章于 2021-01-26 04:39:54 发布

qq_36633275

最新推荐文章于 2021-01-26 04:39:54 发布

阅读量832

点赞数

分类专栏： C++

原文链接：https://www.cnblogs.com/wind-net/archive/2012/11/07/2758556.html

版权

C++ 专栏收录该内容

43 篇文章 1 订阅

订阅专栏

SHGetFileInfo的定义
SHGetFileInfo()函数的工作原理
SHGetFileInfo()函数的返回值

SHGetFileInfo的定义

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变量的设置有关。简单地说，使用这个函数，你可以期望：

确定可执行文件的目标平台(Win32，Win16，MS-DOS)
获取各种有特色的文件图标(小的，大的，有关联重叠的，选中的，打开的)
读出其它显示属性，如文件类型(显示在探测器类型列上的简短描述)和显示名(出现在名字列上)
读出任何其它属性，可以是文件特有的，如，是否可以拷贝，移动，删除或重命名，是否它可以形成一个快捷方式，它是否有子文件夹，是否是共享的，是拖拽目标，或有附加的属性页，等等。
注: 应该注意的是，在调用SHGetFileInfo()之前，必须使用 CoInitialize 或者OleInitialize 初始化COM,否则表面上能够使用，但是会造成不安全或者丧失部分功能。

SHGetFileInfo()函数的工作原理

为了正确地理解函数具有的功能，使用所有可能的方法强制调用这个函数是十分必要的。首先，让我们查看一下他所要求的变量：
在这里插入图片描述
注[1]: 当uFlags的取值中不包含 SHGFI_PIDL时,可直接指定;
当uFlags的取值中包含 SHGFI_PIDL时pszPath要通过计算获得,不能直接指定;

uFlags 参数:指明需要返回的文件信息标识符,常用的有以下常数:
SHGFI_ICON; //获得图标
SHGFI_DISPLAYNAME; //获得显示名
SHGFI_TYPENAME; //获得类型名
SHGFI_ATTRIBUTES; //获得属性
SHGFI_LARGEICON; //获得大图标
SHGFI_SMALLICON; //获得小图标
SHGFI_PIDL; // pszPath是一个标识符
　　函数SHGetFileInfo()的返回值也随uFlags的取值变化而有所不同。

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

注[2]: SHFILEINFO结构定义如下：

typedef struct _SHFILEINFO {
　　HICON hIcon; //文件的图标句柄
　　int iIcon; //图标的系统索引号
　　DWORD dwAttributes; //文件的属性值
　　TCHAR szDisplayName[MAX_PATH]; //文件的显示名
　　TCHAR szTypeName[80]; //文件的类型名
} SHFILEINFO;

此外，这个结构总是用于返回数据到调用程序，并且从不需要初始化。唯一可以包含信息来影响函数行为的是dwAttributes成员，在后面将进一步给出解释。显然，使用SHGetFileInfo()函数各种行为的所有兴趣都集中在对uFlags变量值的设置上。绝大多数情况下，信息经由psfi缓冲返回，但也有些情况，可以有效地包含在函数的DWORD返回之中。