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;
}