FindFirstChangeNotification

要监视指定目录中的变化可以使用FindFirstChangeNotification 函数。此函数创建一个改

变通知对象，设置初始的改变通知过滤条件。在指定的目录或子目录下，当一个符合过滤条件
的改变发生时，一个在通知句柄上的等待将会成功（等待函数返回）。

函数原型如下:

HANDLE FindFirstChangeNotification(

LPCTSTR lpPathName, // 指定要监视的目录

BOOL bWatchSubtree, // 指定是否监视lpPathName 目录下的所有子目录

DWORD dwNotifyFilter // 指定过滤条件
);

dwNotifyFilter 参数指定了能够满足改变通知等待（即能够使等待函数返回）的过滤条件，

可以是以下值的组合：

FILE_NOTIFY_CHANGE_FILE_NAME 要求监视文件名称的改变

FILE_NOTIFY_CHANGE_DIR_NAME 要求监视目录名称的改变

FILE_NOTIFY_CHANGE_ATTRIBUTES 要求监视属性的改变

FILE_NOTIFY_CHANGE_SIZE 要求监视文件大小的改变

FILE_NOTIFY_CHANGE_LAST_WRITE 要求监视最后写入时间的改变

FILE_NOTIFY_CHANGE_SECURITY 要求监视安全属性的改变

函数执行成功返回值是改变通知对象句柄，INVALID_HANDLE_VALUE 是失败后的返回

值。返回的句柄可传递给等待函数（如WaitForSingleObject 等）。当监视的目录或子目录中一

个过滤条件满足的时候，等待就会返回。

等待函数返回之后，应用程序可以处理这个改变，并调用FindNextChangeNotification 函

数继续监视目录。当不再使用这个句柄时，应当调用FindCloseChangeNotification 函数关闭它。
这两个函数的惟一参数是FindFirstChangeNotification 函数返回的句柄。

以下是一个利用上述API函数实现基本的监控程序的例子：（VC6.0编译运行通过）

#include<windows.h>

#include<stdio.h>

#include<conio.h>

void main()

{

//监视C盘根目录下文件名改变的例子，其中while循环一直监控，知道程序关闭

HANDLE hChangeHandle=FindFirstChangeNotification("C:\\",false,FILE_NOTIFY_CHANGE_FILE_NAME);

//判断是否设置成功

if(hChangeHandle==INVALID_HANDLE_VALUE)

{

printf("Find First Change Notification failed\n");

return ;

}

//等待通知 

if(WaitForSingleObject(hChangeHandle,-1)==0)

{

printf("These change a file name\n");

}

//循环等待

while(true)

{

if(FindNextChangeNotification(hChangeHandle))

{

if(WaitForSingleObject(hChangeHandle,-1)==0)

{

printf("These change a file name\n");

}

}

}

//结束监视程序调用FindCloseChangeNotification关闭句柄

FindCloseChangeNotification(hChangeHandle);

//按键退出程序

getch();

}