宜兴通达竭诚为您服务。

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

2016-12-13 13:12:00     作者: Administrator     来源:互联网,版权归作者所有     浏览次数: 273     文字大小:【】【】【

本文从一下几个方法进行介绍:

  •  SHGetFileInfo的定义
  •  SHGetFileInfo()函数的工作原理
  •  SHGetFileInfo()函数的返回值
  •  SHGetFileInfo()函数的简单示例

 

 SHGetFileInfo的定义

       SHGetFileInfo在MSDN上的定义是:

 Retrieves information about an object in the file system,   

  1. such as a file, folder, directory, or drive root.   

       它在shellapi.h中定义。这个函数有五个变量,定义如下:

       基本上讲,SHGetFileInfo()函数提供关于文件系统对象的信息。如前面解释的,这个对象可以是文件,文件夹,目录或驱动器根。DWORD的返回是指可能有相当多的返回状态,这与uFlags变量的设置有关。简单地说,使用这个函数,你可以期望:

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

SHGetFileInfo()函数的工作原理

       为了正确地理解函数具有的功能,使用所有可能的方法强制调用这个函数是十分必要的。首先,让我们查看一下他所要求的变量:

变量名

描述

pszPath

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

dwFileAttributes

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

Psfi

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

cbFileInfo

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

uFlags

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

 注[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返回之中。

 SHGetFileInfo()函数的返回值

 

  1. If uFlags contains the SHGFI_EXETYPE flag, the return value specifies  
  2. the type of the executable file. It will be one of the following values:   
ValueExecutable File Type
0Nonexecutable file or an error condition
LOWORD = NE or PE and HIWORD = 3.0, 3.5, or 4.0Windows application
LOWORD = MZ and HIWORD = 0MS-DOS .exe, .com, or .bat file
LOWORD = PE and HIWORD = 0Win32 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,它包含了指定文件或文件夹的图标。

相关文章 评论

服务原则及地区范围

宜兴通达团队,在企业网络维护和企业信息化建设与咨询方面,有10多年经验。

我团队愿与客户一道,力求彻底解决客户问题!
我们不是在给企业提供“头痛医头、脚痛医脚”的暂时解决方案,而是在部署根本性安全与稳定服务!!
我们愿携手客户,建立企业IT规划;杜绝随意安装系统、软件等操作;力求共同维护有序、安全、稳定的网络办公环境!!!
IT服务,服务是根本,客户是上帝;我们提供快速响应、快速上门、快速排查,提供优质高效的服务!!!!

通达团队提供全国范围内的服务,服务形式包括远程协助、电话咨询、电子邮件咨询、传真咨询、问答平台的问题解决等。

宜兴地区提供上门服务:

  • 市区服务:宜城街道、城北街道(屺亭街道)、新街街道、新庄街道、环科园、渚桥开发区
  • 市郊服务:张渚镇、西渚镇、太华镇、徐舍镇、官林镇、杨巷镇、新建镇、和桥镇、高塍镇、万石镇、周铁镇、芳桥镇、丁蜀镇、湖父镇。
  • 联系电话:189-21-343434
  • 在线沟通: