CListCtrlEx：一个支持文件拖放和实时监视的列表控件——用未公开API函数实现Shell实时监视

一、需求
无论何时，当你在Explorer窗口中创建、删除或重命名一个文件夹/文件，或者插入拔除移动存储器时，Windows总是能非常快速地更新它所有的视图。有时候我们的程序中也需要这样的功能，以便当用户在Shell中作出创建、删除、重命名或其他动作时，我们的应用程序也能快速地随之更新。
二、原理
Windows内部有两个未公开的函数（注：在最新的MSDN中，已经公开了这两个函数），分别叫做SHChangeNotifyRegister和SHChangeNotifyDeregister，可以实现以上的功能。这两个函数位于Shell32.dll中，是用序号方式导出的。这就是为什么我们用VC自带的Depends工具察看Shell32.dll时，找不到这两个函数的原因。SHChangeNotifyRegister的导出序号是2；而SHChangeNotifyDeregister的导出序号是4。
SHChangeNotifyRegister可以把指定的窗口添加到系统的消息监视链中，这样窗口就能接收到来自文件系统或者Shell的通知了。而对应的另一个函数，SHChangeNotifyDeregister，则用来取消监视钩挂。SHChangeNotifyRegister的原型和相关参数如下：
ULONG SHChangeNotifyRegister
(         
HWND  hwnd,
    int   fSources,
    LONG  fEvents,
    UINT    wMsg,
    Int  cEntries,
    SHChangeNotifyEntry *pfsne
);
其中：
hwnd
将要接收改变或通知消息的窗口的句柄。
fSource
指示接收消息的事件类型，将是下列值的一个或多个（注：这些标志没有被包括在任何头文件中，使用者须在自己的程序中加以定义或者直接使用其对应的数值）
SHCNRF_InterruptLevel
0x0001。接收来自文件系统的中断级别通知消息。
SHCNRF_ShellLevel
0x0002。接收来自Shell的Shell级别通知消息。
SHCNRF_RecursiveInterrupt
0x1000。接收目录下所有子目录的中断事件。此标志必须和SHCNRF_InterruptLevel 标志合在一起使用。当使用该标志时，必须同时设置对应的SHChangeNotifyEntry结构体中的fRecursive成员为TRUE（此结构体由函数的最后一个参数pfsne指向），这样通知消息在目录树上是递归的。
SHCNRF_NewDelivery
0x8000。接收到的消息使用共享内存。必须先调用SHChangeNotification_Lock，然后才能存取实际的数据，完成后调用SHChangeNotification_Unlock函数释放内存。
fEvents
要捕捉的事件，其所有可能的值请参见MSDN中关于SHChangeNotify函数的注解。
wMsg
产生对应的事件后，发往窗口的消息。
cEntries
pfsne指向的数组的成员的个数。
pfsne
SHChangeNotifyEntry结构体数组的起始指针。此结构体承载通知消息，其成员个数必须设置成1，否则SHChangeNotifyRegister或者SHChangeNotifyDeregister将不能正常工作（但是据我试验，如果cEntries设为大于1的值，依然可以注册成功，不知何故）。
如果函数调用成功，则返回一个整型注册标志号，否则将返回0。同时系统就会将hwnd指定的窗口加入到操作监视链中，当有文件操作发生时，系统会向hwnd标识的窗口发送wMsg指定的消息，我们只要在程序中加入对该消息的处理函数就可以实现对系统操作的监视了。
如果要退出程序监视，就要调用另外一个未公开得函数SHChangeNotifyDeregister来取消程序监视。该函数的原型如下：
BOOL SHChangeNotifyDeregister(ULONG ulID);
其中ulID指定了要注销的监视注册标志号，如果卸载成功，返回TRUE，否则返回FALSE。
三、实例
在前一文中，我们派生了一个支持文件拖放的列表控件CListCtrlEx，但它还有一个小小的缺憾，就是当用户把一个文件拖放进来之后，如果用户在Shell中对该文件进行移动、删除、重命名等操作时，CListCtrlEx将不能保证实时更新。经过上面的讨论，现在就让我们为CListCtrlEx加上实时文件监控功能。
在使用这两个函数之前，必须要先声明它们的原型，同时还要添加一些宏和结构定义。我们在原工程中添加一个ShellDef.h头文件，然后加入如下声明：
#define SHCNRF_InterruptLevel  0x0001 //Interrupt level notifications from the file system
#define SHCNRF_ShellLevel   0x0002 //Shell-level notifications from the shell
#define SHCNRF_RecursiveInterrupt  0x1000 //Interrupt events on the whole subtree
#define SHCNRF_NewDelivery   0x8000 //Messages received use shared memory

typedef struct
{
    LPCITEMIDLIST pidl; //Pointer to an item identifier list (PIDL) for which to receive notifications
    BOOL fRecursive; //Flag indicating whether to post notifications for children of this PIDL
}SHChangeNotifyEntry;

typedef struct
{
    DWORD dwItem1;  // dwItem1 contains the previous PIDL or name of the folder.
    DWORD dwItem2;  // dwItem2 contains the new PIDL or name of the folder.
}SHNotifyInfo;

typedef ULONG
(WINAPI* pfnSHChangeNotifyRegister)
(
 HWND hWnd,
 int  fSource,
 LONG fEvents,
 UINT wMsg,
 int  cEntries,
 SHChangeNotifyEntry* pfsne 
);

typedef BOOL (WINAPI* pfnSHChangeNotifyDeregister)(ULONG ulID);
这些宏和函数的声明，以及参数含义，如前所述。下面我们要在CListCtrlEx体内添加两个函数指针和一个ULONG型的成员变量，以保存函数地址和返回的注册号。
接下来我们为CListCtrlEx类添加一个公有成员函数Initialize，在其中，我们首先进行加载Shell32.dll以及初始化函数指针动作，接着调用注册函数向Shell注册。用户在使用我们提供的CListCtrlEx类时，应当在CListCtrlEx创建完毕后跟着调用Initialize函数以确保注册了消息监视钩子。否则将失去实时监视功能。初始化函数如下（已略去涉及OLE初始化的部分）：
BOOL CListCtrlEx::Initialize()
{
 …………
 //加载Shell32.dll
 m_hShell32 = LoadLibrary("Shell32.dll");
 if(m_hShell32 == NULL)
 {
  return FALSE;
 }

 //取函数地址
 m_pfnDeregister = NULL;
 m_pfnRegister = NULL;
 m_pfnRegister = (pfnSHChangeNotifyRegister)GetProcAddress(m_hShell32,MAKEINTRESOURCE(2));
 m_pfnDeregister = (pfnSHChangeNotifyDeregister)GetProcAddress(m_hShell32,MAKEINTRESOURCE(4));
 if(m_pfnRegister==NULL || m_pfnDeregister==NULL)
 {
  return FALSE;
 }

 SHChangeNotifyEntry shEntry = {0};
 shEntry.fRecursive = TRUE;
 shEntry.pidl = 0;
 m_ulNotifyId = 0;
 
 //注册Shell监视函数
 m_ulNotifyId = m_pfnRegister(
        GetSafeHwnd(),
        SHCNRF_InterruptLevel|SHCNRF_ShellLevel,
        SHCNE_ALLEVENTS,
        WM_USERDEF_FILECHANGED, //自定义消息
        1,
        &shEntry
       );
 if(m_ulNotifyId == 0)
 {
  MessageBox("Register failed!","ERROR",MB_OK|MB_ICONERROR);
  return FALSE;
 }
 return TRUE;
}
在CListCtrlEx类中再添加如下函数。该函数的作用是从PIDL中解出实际字符路径。
CString CListCtrlEx::GetPathFromPIDL(DWORD pidl)
{
    char szPath[MAX_PATH];
    CString strTemp = _T("");
    if(SHGetPathFromIDList((struct _ITEMIDLIST *)pidl, szPath))
 {
        strTemp = szPath;
    }
    return strTemp;
}
    现在我们的程序就可以接收到来自Shell或文件系统的通知消息了，只要编写一个处理自定义消息的函数，就可以对系统范围内的更改动作作出我们希望的响应动作。这里lParam参数中存放的是当前发生的事件（譬如SHCNE_CREATE），wParam参数中存放的是SHNotifyInfo结构。下面是一段框架代码：
LRESULT CListCtrlEx::OnFileChanged(WPARAM wParam, LPARAM lParam)
{
    CString  strOriginal = _T("");
 CString  strCurrent = _T("");
 SHNotifyInfo* pShellInfo = (SHNotifyInfo*)wParam;

 strOriginal = GetPathFromPIDL(pShellInfo->dwItem1);
 if(strOriginal.IsEmpty())
 {
  return NULL;
 }

 switch(lParam)
 {
 case SHCNE_CREATE:
  break;

 case SHCNE_DELETE:
  break;
 case SHCNE_RENAMEITEM:
  break;
    }
    return NULL; 
}
四、总结
至此我们完成了对CListCtrlEx的扩充工作，通过这两个未公开的API函数，编写一个文件夹/文件监视器不再是一件难事。当然同样的功能也可以通过编写设备驱动程序来，但这种方法来实现，难度大，周期长，开发上也有不少困难。

本文地址：http://com.8s8s.com/it/it822.htm