Click here to Skip to main content
11,718,016 members (78,307 online)
Click here to Skip to main content

How to get a notification if change occurs in a specified directory

, 3 Aug 2003 106.1K 5K 47
Rate this:
Please Sign up or sign in to vote.
This article discusses how to handle file system notification events.

Sample Image - DirCheck.gif

Introduction

Sometimes, its is very important to monitor events, occurring in some directory. For example, if new file was saved in a specified directory, the application must to do something.

Background

File system notification events can be obtained by the Win32 API function FindFirstChangeNotification (look more in detail in the MSDN). This function creates a change notification handle and sets up initial change notification filter conditions. A wait on a notification handle succeeds when a change matching the filter conditions occurs in the specified directory or subtree. After the wait has been satisfied, the application can respond to this condition and continue monitoring the directory, by calling the FindNextChangeNotification function and the appropriate wait function. When the handle is no longer needed, it can be closed by using the FindCloseChangeNotification function.

The classes

CNotifyDirCheck class holds notification events in the work thread and parse file tree for finding a new (changed) file. User must override the Action function of the base class or implement own notification callback. This callback has the following prototype:

UINT DefaultNotificationCallback(
CFileInformation fiObject,  //file (directory) information object
EFileAction       faAction,  //notification event type
LPVOID           lpData );  //user's data pointer

If the callback succeeds, the return value is 0. If the callback failed, the return value must be an error number (>0). Samples of the callback and virtual function Action exists in the code of the class CNotifyDirCheck.

Class CFileInformation is a useful API wrapping class that is developed to make file manipulation and to obtain information about files and directories in a simpler and easier way.

How to Use

  1. Create an object of CNotifyDirCheck.
  2. Create notification callback or override virtual function Action.
  3. Select directory.
  4. Add the user’s data pointer (if needed).
  5. Call method Run to start notification thread.
  6. Call method Stop to stop notification thread (or this method will be called in destructor).
CNotifyDirCheck m_ndc;
…
UINT DirCallback(...) {...}
...
m_ndc.SetDirectory( m_dir );//root directory
m_ndc.SetData( this );//user’s data
m_ndc.SetActionCallback( DirCallback );//user’s callback
…
m_ndc.Run();//start workthread
...
m_ndc.Stop();//stop workthread

Conclusion

I would like to mention thanks to CodeProject authors for many great ideas and useful source code. I'd be glad if somebody uses my class. Please let me know of any bugs that you have found and I will fix them in a future release.

References

  1. MSDN
  2. CodeProject - Files & Folders

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

jukov
Software Developer (Senior) Elmo Motion Control
Israel Israel
Software developer since 1992

You may also be interested in...

Comments and Discussions

 
QuestionBig folder Pin
meocon3572-Apr-15 13:55
membermeocon3572-Apr-15 13:55 
QuestionLicense? Pin
dripfeed5-Mar-13 23:20
memberdripfeed5-Mar-13 23:20 
GeneralMultiple Notifications Pin
DoGuy10-Oct-05 3:31
memberDoGuy10-Oct-05 3:31 
GeneralRe: Multiple Notifications Nice Job Pin
bruno leclerc2-Feb-06 23:58
memberbruno leclerc2-Feb-06 23:58 
GeneralRe: Multiple Notifications Nice Job Pin
acjohnson5517-Jul-06 12:17
memberacjohnson5517-Jul-06 12:17 
GeneralMultiple notifications Pin
Madhu Reddy9-Mar-05 1:23
memberMadhu Reddy9-Mar-05 1:23 
Generalsome bug... Pin
boy061212-May-04 20:35
memberboy061212-May-04 20:35 
GeneralGreat help! Pin
mr.axe6-Oct-03 8:39
membermr.axe6-Oct-03 8:39 
GeneralHello Monster! Pin
Laguna Men13-Aug-03 8:53
sussLaguna Men13-Aug-03 8:53 
GeneralRe: Hello Monster! Pin
jukov23-Aug-03 21:01
memberjukov23-Aug-03 21:01 
QuestionIs this better? Pin
Anonymous4-Aug-03 7:35
sussAnonymous4-Aug-03 7:35 
AnswerRe: Is this better? Pin
dwccgc5-Aug-03 10:14
memberdwccgc5-Aug-03 10:14 
GeneralRe: Is this better? Pin
zhulei_cug13-Oct-05 17:15
memberzhulei_cug13-Oct-05 17:15 
GeneralERROR N50 Pin
dwccgc4-Aug-03 6:54
memberdwccgc4-Aug-03 6:54 
GeneralRe: ERROR N50 Pin
jukov6-Aug-03 21:49
memberjukov6-Aug-03 21:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.150901.1 | Last Updated 4 Aug 2003
Article Copyright 2003 by jukov
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid