BROWSEINFO结构体

BROWSEINFO的结构如下：

typedef struct _browseinfo { 

    HWND hwndOwner;        

       // 父窗口句柄

    LPCITEMIDLIST pidlRoot;              

      // 要显示的文件夾的根(Root)

    LPTSTR pszDisplayName; 

      // 保存被选取的文件夾路径的缓冲区

    LPCTSTR lpszTitle;            

       // 显示位于对话框左上部的标题

    UINT ulFlags;              

      // 指定对话框的外观和功能的標志

    BFFCALLBACK lpfn;                    

      // 处理事件的回调函数

    LPARAM lParam;               

      // 应用程序传给回调函数的参数

    int iImage;               

      // 保存被选取的文件夾的图片索引

} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO

pszDisplayName
 　　-- 這個参数指向一個缓冲区，SHBrowseForFolder默认这个缓冲区的大小为MAX_PATH(系统定义的宏，表示一个路径名的最大长度)，并用它来保存被选取的文件夹的路径。

　　ulFlags --
　　SHBrowseForFolder允许我们指定对话框的功能和外观，这个参数正是起这样的用途。它的值可以由十几个宏组合而成。比如BIF_RETURNNONLYFSDIRS是返回文件系统的目录，BIF_BROWSEFORCOMPUTER是返回网络上的计算机名，BIF_EDITBOX是显示一个编辑框，允许用户输入文件夾名。一般来说，如果是简单的用于选择一个文件夹，设置ulFlags = BIF_RETURNONLYLYFSDIRS即可。

　　pidRoot --
　　它指向一个ITEMIDLIST结构，作为在列表中显示的文件夹的根目录，如果为NULL則默认为Desktop。ITEMIDLIST结构除了用在这里外，它还用作函数的返回值(參看函数原型)。那为什么不用字符串来表示这个目录呢，这个结构怎样表示一个目录呢?下面作一個简单的介紹。

ITEMID和ITEMIDLIST

　　Windows Shell的一个功能在于管理并提供方法存取系统中的众多对像，這些对像包括了文件，网路上的计算机，控制面板程序，回收站等等，为了识别每一个对像，Windows Shell使用了Item ID来表示它們，而Iten ID Lists用来表示一个对像的路径。所以，ITEMID和ITEMIDLIST的关系类似于文件名和路径的关系。如果只对文件系统而言的话，ITEMIDLIST可以看成是路径的另一中表示法，Windows Shell也提供了函数來进行转化。

　　BOOL SHGetPathFromIDList( LPCITEMIDLIST pidl, LPSTR pszPath )
　这个函数將一个ITEMLIST转换成文件系统中的路径。

 

返回值

　　SHBrowseForFolder的返回值也是一个指向ITEMIDLIST的指針。这个ITEMIDLIST正式表示了用戶所选择的文件夹。如上所述，通过SHGetPathFromIDList，就可以获得一个文件夹Path的字符串。

　　要注意的是返回的指針必须由应用程序自己来释放。并且，由于SHBrowseForFolder是通贵调用IMalloc Interface来分配Memory，所以，也必须通过这个Interface來释放。

实例：