SHGetDesktopFolder编程应用

所谓Shell（壳），一般是指由操作系统提供的，用于计算机用户向操作系统输入相关指令并得到结果的程序。Shell可以字符形式的，也可以是图形界面形式的。
    Windows Shell最重要的组成部件是explorer.exe。在使用Windows操作系统时，开始菜单、任务栏、资源管理器等都是explorer.exe提供的。因此Shell程序设计也是图形用户界面设计的重要组成部分。掌握Shell程序设计，需首先了解下面4个方面的内容。
(1) Windows Shell编程接口。
     Windows Shell提供一系列编程接口，例如可以获取特殊文件夹，使用文件浏览对话框等。
    Shell编程接口的函数名通常是以“SH”开始。
(2) Windows Shell扩展。
    Windows平台的Shell是可扩展的。可以为Windows
Shell开发扩展程序(Extention)，例如：
◇定制不同类型的文件的右键菜单、拖拽菜单（比如WinRAR、Adobe
Acrobat等应用程序具有这样的功能）；
◇开发系统通知区域图标、并为图标定制菜单和气泡弹出功能(QQ、MSN、Visual
Studio等应用程序具有这样的功能)；
◇定制任务栏、定制工具栏等；
◇增加自动播放对话框中的选项；
◇添加控制面板项；
◇为不同文件类型文件属性页、文件夹的属性页（右键属性）增加选项页。
上面是几种典型的Shell扩展应用。
(3)注册表在Shell应用中具有重要作用。
Shell应用在很大程度上依赖于注册表，举例如下。
◇文件类型辅助：特定扩展名的文件的图标、默认打开程序等是通过注册表来配置的。
◇Shell扩展的安装：比如特定类型文件的右键菜单、拖拽菜单(Context
Meun)的菜单项及输入处理函数所在的动态链接库。
(4)相关头文件和库文件。
    进行Shell程序的设计，需要使用一些头文件和库文件。
    一般Shell API都在shlobj.h头文件中声明，由She1132.dll导出，链接时需要使用到She1132.lib库。
一、目录管理
1、基本介绍
    计算机用户使用Shell最常进行的操作就是文件操作。Shell最重要的功能之一是进行文件浏览、查找、管理以及将文件和应用程序关联。
Windows Shell中有很多特殊目录和文件，比如所有Windows用户都经常接触到的“我的文档”、“桌面”、“回收站”、“程序文件”(Program
files)等。这些目录都是Shell特殊目录。可以通过Shell程序设计接口开发程序，获取和操作这些特殊目录。
Shell有一种特殊的文件和目录管理方式，每个目录都有一个PIDL (Pointer of Item identifier
list，项标识符表指针)值，这个值惟一标识一个文件夹。
由系统定义的特殊文件夹的CSIDL (constant special item ID list)是常数，比如：
CSIDL_ DESKTOP代表“桌面”文件夹，是根目录；
CSIDL_FAVORITES代表“收藏夹”；
CSIDL_FONTS代表字体文件夹；
CSIDL_MYDOCUMENTS，代表“我的文档”；
CSIDL_MYMUSIC代表“我的音乐”；
CSIDL PROFILE代表“用户”文件夹，一般情况下是C:\Documents and Settings\username;
CSIDL_PROGRAMS代表“程序”文件夹，一般情况下是C:\Program Files; ．
CSIDL_RECENT，代表“最近的文档”；
CSIDL_STARTMENU，代表“开始菜单”目录；
CSIDL_SYSTEM、CSIDL_WINDOWS分别代表“系统”和“Windows”目录。
SHGetNameFromIDList、SHGetPathFromIDList等Shell
API函数通过CSIDL获得有关于目录的详细信息。
2、操作“我的文档”等特殊目录
    操作“我的文档”等特殊目录相关操作涉及的API：
SHGetSpecialFolderPath通过文件夹的CSIDL，获得文件夹的路径;
SHGetFolderLocation获取文件夹的路径，并保存在ITEMIDLIST结构中;
SHGetPathFromIDList从PIDL转换为路径。
    两种方法来获取特殊文件夹的路径，一种是直接使用SHGetSpecialFolderPath,
另外一种更为通用，使用SHGetFolderLocation从PIDL或CSIDL获得文件夹位置后，再使用SHGetPathFromIDList获取文件路径字符串。

获取并显示特殊目录，遍历回收站示例

/* 头文件　*/

#include <Windows.h>

#include <shlobj.h>

#include <stdio.h>

/* 函数申明　*/

DWORD ListFileInRecycleBin();

VOID GetSpecialFolder();

/*************************************

* int main()

* 功能    调用相关函数

*

* 参数    未使用

**************************************/

int main()

{

    GetSpecialFolder();

    ListFileInRecycleBin();

}

/*************************************

* VOID GetSpecialFolder()

* 功能    获取并显示特殊目录

*

* 参数    未使用

**************************************/

VOID GetSpecialFolder()

{

    // 获取我的文档的路径

    CHAR szMyDocument[MAX_PATH];// My Document的路径

    // 使用SHGetSpecialFolderPath获取特殊目录路径

    SHGetSpecialFolderPath(NULL,szMyDocument,CSIDL_PERSONAL,FALSE);

    // 获取桌面的路径

    CHAR szDesktop[MAX_PATH];    //DeskTop的路径

    LPITEMIDLIST pidl = NULL;

    LPMALLOC pMalloc = NULL;

    // 分配

    SHGetMalloc(&pMalloc);

    // 使用SHGetFolderLocation、SHGetPathFromIDList可以获取任意目录的路径

    SHGetFolderLocation(NULL, CSIDL_DESKTOPDIRECTORY, NULL, 0, &pidl);

    SHGetPathFromIDList(pidl,szDesktop);

    // 释放

    pMalloc->Free(pidl);

    pMalloc->Release();

    // 显示结果

    printf("My Document:\t %s\n",szMyDocument);

    printf("DeskTop:\t %s\n",szDesktop);

}

/*************************************

* VOID ListFileInRecycleBin()

* 功能    遍历并显示回收站中的文件

*

* 参数    未使用

**************************************/

DWORD ListFileInRecycleBin()

{

    CHAR pszPath[MAX_PATH];        // 保存路径

    // IShellFolder接口

    IShellFolder *pisf = NULL;

    IShellFolder *pisfRecBin = NULL;

    // 获取“根”目录，桌面

    SHGetDesktopFolder(&pisfRecBin);

    

    IEnumIDList *peidl = NULL;    // 对象遍历接口

    LPITEMIDLIST pidlBin = NULL;

    LPITEMIDLIST idlCurrent = NULL;

    LPMALLOC pMalloc = NULL;

    // 分配

    SHGetMalloc(&pMalloc);

    // 回收站位置

    SHGetFolderLocation(NULL, CSIDL_BITBUCKET, NULL, 0, &pidlBin);

    // 绑定回收站对象

    pisfRecBin->BindToObject(pidlBin,NULL,IID_IShellFolder,(void **) &pisf);

    // 列举回收站中的对象,得到IEnumIDList接口，包括SHCONTF_FOLDERS、

    // SHCONTF_NONFOLDERS、SHCONTF_INCLUDEHIDDEN类型的对象

    pisf->EnumObjects(NULL,

        SHCONTF_FOLDERS | SHCONTF_NONFOLDERS |SHCONTF_INCLUDEHIDDEN,

        &peidl);

    STRRET strret;

    ULONG uFetched;

    HANDLE hOutPut = GetStdHandle(STD_OUTPUT_HANDLE);

    printf("\nFiles In Recycle Bin:\n");

    while(1)

    {

        // 遍历IEnumIDList对象，idlCurrent为当前对象

        if(peidl->Next(1,&idlCurrent,&uFetched) == S_FALSE)

            break;

        // 获取回收站当前对象当前的路径，这里没有输出结果，读者可自行修改

        SHGetPathFromIDList(idlCurrent,  pszPath);

        // DisplayName，删除前的路径

        pisf->GetDisplayNameOf(idlCurrent,SHGDN_NORMAL,&strret);

        // 显示，printf可能会造成字符编码不正确。

        WriteConsoleW(hOutPut,L"\t",1,NULL,NULL);

        WriteConsoleW(hOutPut,strret.pOleStr,lstrlenW(strret.pOleStr),NULL,NULL);

        WriteConsoleW(hOutPut,L"\n",1,NULL,NULL);

    }

    // 释放资源

    pMalloc->Free(pidlBin);

    pMalloc->Free(strret.pOleStr);

    pMalloc->Release();

    peidl->Release();

    pisf->Release();

    return 0;    

}

3、绑定、遍历、属性获取
1）相关API，接口，数据结构
SHGetDesktopFolder是获取以IShellFolder接口形式返回的桌面文件夹
2）IShellFolder接口
IshellFolder是Windows Shell程序对目标进行管理的一个重要接口。每一个目录对应一个实例化的IshellFolder接口。IshellFolder接口的成员包括EnumObj
ects、GetAttributesOf、GetDisplayNameOf等。[2]
3)IEnumIDList接口。
IEnumIDList接口提供了一组标准的方法，用于遍历PIDL (Item identifier lists的指针)，其成员包括Clone、Next、Reset、Skip等。[3]
示例代码，见上。
3、浏览文件对话框
示例代码
弹出“浏览文件夹”对话框

/* 头文件　*/

#include <Windows.h>

#include <shlobj.h>

/* 函数申明　*/

DWORD Browse(HWND hwnd) ;

/*************************************

* WinMain

* 功能    程序入口点，调用Browse

*

* 参数    未使用

**************************************/

int WINAPI WinMain(

                   HINSTANCE hInstance,

                   HINSTANCE hPrevInstance,

                   LPSTR lpCmdLine,

                   int nCmdShow

                   )

{

    Browse(NULL); 

}

/*************************************

* WinMain

* 功能    弹出“浏览文件夹”对话框，

并获取用户选择的文件夹目录

*

* 参数    HWND hwnd    父窗口句柄

**************************************/

DWORD Browse(HWND hwnd) 

{

    // 用于保存路径

    CHAR szRoot[MAX_PATH];

    CHAR szChoose[MAX_PATH];

    CHAR szDisplayName[MAX_PATH];

    // 相关变量

    LPITEMIDLIST pidlRoot = NULL;

    LPITEMIDLIST pidlSelected = NULL;

    BROWSEINFO bi = {0};

    LPMALLOC pMalloc = NULL;

    // “浏览文件夹”的根路径，开发人员可根据情况选择，比如只浏览“我的文档”。

    SHGetFolderLocation(NULL, CSIDL_DESKTOP, NULL, 0, &pidlRoot);

    SHGetPathFromIDList(pidlRoot,szRoot);

    // 填充 BROWSEINFO 结构

    bi.hwndOwner = hwnd;

    bi.pidlRoot = pidlRoot;

    bi.pszDisplayName = szDisplayName;

    bi.lpszTitle = "Choose a target";

    bi.ulFlags = 0;

    bi.lpfn = NULL;

    bi.lParam = 0;

    // 弹出对话框

    pidlSelected = SHBrowseForFolder(&bi);

    // DisplayName

    MessageBox(NULL,szDisplayName,"Display Name:",MB_OK);

    // 选择的文件夹

    SHGetPathFromIDList( pidlSelected, szChoose );

    MessageBox(NULL,szChoose,"Choose:",MB_OK);

    // 释放

    ILFree(pidlRoot);

    return 0;

}