翻译自MSDN 2005 -> Win32 和 COM 开发 -> User Interface -> Windows User Experience -> Windows Shell -> Shell Programmer's Guide -> Shell Basics -> Shell Basics: Programming the Shell -> Getting Information About the Contents of a Folder
Getting a Folder's ID 讨论了两种获取Shell对象PIDL的方法。一个显然的问题是:获取PIDL后,可以用它做什么?一个相关问题是:哪种方法可以用于你的程序,或者适合 你的程序?要回答这两个问题需要更深入考察下名字空间是如何实现的。名字空间实现的关键是IShellFolder接口。
使用IShellFolder接口
前面的文档中,名字空间文件夹被称作“对象”。这个术语的使用好像不太严格,但实际上从严格意义上讲,这个术语也是合适的,因为每个名字空间文件夹都由一 个COM对象表示。每个文件夹对象实现了很多可以用于各种任务的接口。有些接口是可选的,不是每个文件夹都实现了,但每个文件夹都必须实现基本接口IShellFolder 。
要使用文件夹,首先需要获取其IShellFolder 接口指针。IShellFolder接口指针除了可以提供对对象其他接口的访问外,还提供了处理很多通常任务的方法,本文将讨论某些通常任务。
要获取Shell对象的IShellFolder 接口指针,首先调用SHGetDesktopFolder ,它会返回名字空间根,即桌面的IShellFolder 接口指针。获取了桌面对象的IShellFolder接口指针后,有很多方法进行下一步。
如果已经有要处理的文件夹的PIDL了(比如说,通过SHGetFolderLocation 获取的),可以用桌面对象的(IShellFolder接口指针的)BindToObject 方法获取文件夹的IShellFolder 接口指针。如果已经有文件系统对象的路径了,可以先用桌面对象的ParseDisplayName 方法获取其PIDL,然后再调用BindToObject 。如果这两种方法都不可用,可以用IShellFolder 的其他方法浏览名字空间(并定位到要处理的文件夹),详情请参考Navigating the Namespace 。
枚举文件夹内容
文件夹处理的第一件事通常是看看它包含什么内容,这时可以先调用文件夹的EnumObjects 方法。方法会创建标准OLE枚举对象并返回其IEnumIDList 接口。枚举接口含有4个标准方法:Clone 、Next 、Reset 、Skip 。这些方法可用于枚举文件夹内容。
枚举文件夹内容的基本过程是:
-
调用EnumObjects 方法获取枚举对象的IEnumIDList 接口
-
调用IEnumIDList 的Next 方法,传入一个未分配的PIDL。Next 会为PIDL分配内存,但须由调用方释放分配的内存。Next 返回的PID只含有对象的item ID和表示结束的NULL字符。也就是说,返回的是相对于所在文件夹的单层PIDL,不是全限定PIDL。
-
重复步骤2直到Next 方法返回S_FALSE ,这表示所有内容条目已经枚举完成。
-
调用IEnumIDList::Release 释放枚举对象。
注意:要注意当前使用的是相对PIDL还是全限定PIDL。某些函数可以接受两种类型的PIDL,但是有些却只能接受一种类型的。IEnumIDList的另外3个方法可用于重复枚举文件夹内容。这3个方法可以复位枚举过程、跳过一个或者多个对象、制作枚举对象的副本以保存其状态。
确定显示名和其他属性
在枚举了文件夹包含的所有PIDL后,就可以发现它们所代表的对象类型。IShellFolder 接口提供了很多有用的方法,这里只讨论两个。IShellFolder 接口的其他方法和其他Shell文件夹接口在本系列后面的文章中讨论。
显示名是对象的最重要属性之一。要获取对象的显示名,把PIDL传递给GetDisplayNameOf 即可。对象可以位于名字空间中父文件夹以下的任何地方,但PIDL必须是相对于父文件夹的。
GetDisplayNameOf 把显示名作为STRRET 对象的一部分返回。因为从STRRET 结构取出显示名需要一点技巧,所以Shell为你提供了两个函数,StrRetToStr 和StrRetToBuf 。这两个函数都需要一个STRRET 结构体,把显示名作为普通字符串返回。它们的不同在于字符串是如何分配的。
除了显示名外,对象还可以有很多其他属性,比如说,对象是否是文件夹,是否可以被移动。把对象的PIDL传给GetAttributesOf 就可以获取其属性。完整的属性列表很长,细节可以参考相关文档。注意传递给GetAttributesOf 的PIDL必须是单层的。特别是,GetAttributesOf 可以接受Next 返回的PIDL。可以传入一个PIDL数组,GetAttributesOf 会返回数组中所有对象共有的属性。
如果有对象的全限定路径名或者PIDL,SHGetFileInfo 提供了一种获取足够用于多种目的的对象信息的简单方法。SHGetFileInfo 返回的信息包括:
-
对象的显示名
-
对象属性
-
对象图标句柄
-
系统图像列表句柄
-
包含对象图标的文件的路径
获取子文件夹的IShellFolder接口指针
调用GetAttributesOf ,检查SFGAO_FOLDER 标志是否已设置就可以确定文件夹是否含有子文件夹。如果对象是文件夹,就可以绑定到它,这可以提供对象的IShellFolder 接口。
要绑定到文件夹,调用父文件夹的BindToObject 方法。方法要求传入子文件夹的PIDL,并返回其IShellFolder 接口指针。有了这个指针后,就可以枚举文件夹的内容,确定其属性等。
确定对象的父文件夹
如果已有某对象的PIDL,可能需要其父文件夹暴露的某个接口。比如说,如果想用GetDisplayNameOf 确定父文件夹的显示名,必须先获取父对象的IShellFolder 接口。可以用上一节讨论的技术来达到目的,但有一种更简单的方法,就是使用SHBindToParent 方法。这个方法要求传入对象的全限定PIDL,并且返回父文件夹的特定接口指针。SHBindToParent 还可以返回对象的单层PIDL以用于GetAttributesOf 等方法。
下面的示例控制台应用程序获取系统特别文件夹的PIDL,并且返回其显示名。
#include <shlobj.h>
|
应用程序首先获取Shell分配器的IMalloc 接口指针,并且用SHGetFolderLocation 获取系统文件夹的PIDL。然后程序调用SHBindToParent 获取系统文件夹父文件夹的IShellFolder 接口,以及相对于父文件夹的PIDL。然后使用父文件夹的GetDisplayNameOf 方法获取系统文件夹的显示名。
对于GetDisplayNameOf返回的STRRET结构体,可以用StrRetToBuf把显示名转换成普通字符串。在显示了显示名后,接口指针和系统PIDL都被释放。注意不能释放SHBindToParent返回的相对PIDL。
本文转载自:http://blog.sina.com.cn/s/blog_56dee71a0100frhy.html