FindNextChangeNotification (Compact 2013)

  • Article

3/26/2014

This function requests that the OS signal a change notification handle the next time it detects an appropriate change.

Syntax

BOOL FindNextChangeNotification(
  HANDLE hChangeHandle
);

Parameters

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

After this function returns successfully, the application can wait for notification that a change has occurred by using the wait functions.

If a change occurs after a call to FindFirstChangeNotification but before a call to this function, the OS records the change. When this function runs, the recorded change immediately satisfies a wait for the change notification.

Do not use this function more than once on the same handle without using one of the wait functions. An application can miss a change notification if it uses this function when there is a change request outstanding.

When you no longer need hChangeHandle, close it by using the FindCloseChangeNotification function.

Requirements

Header

winbase.h

Library

coredll.lib

See Also

Reference

File I/O Functions
FindCloseChangeNotification
FindFirstChangeNotification