SHGetFileInfo()函数

最新推荐文章于 2012-11-02 20:57:08 发布

阳阳2013哈哈

最新推荐文章于 2012-11-02 20:57:08 发布

阅读量2.2k

点赞数

CC 4.0 BY-SA版权

文章标签： attributes struct path

本文链接：https://blog.youkuaiyun.com/mynote/article/details/364705

本文详细介绍了SHGetFileInfo函数，包括其参数如pszPath（指定文件名）、dwFileAttributes（文件属性）等的含义和使用条件，还说明了psfi参数返回的文件信息结构体。同时列举了uFlags参数常用常数，指出函数返回值随uFlags变化，调用该函数可获取文件图标句柄，但不使用SHGFI_PIDL时无法获取虚拟文件夹信息。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

DWORD_PTR SHGetFileInfo(
    LPCTSTR pszPath,
    DWORD dwFileAttributes,
    SHFILEINFO *psfi,
    UINT cbFileInfo,
    UINT uFlags
);

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

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

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

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

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()不能获得“我的电脑”等虚似文件夹的信息。