Share via


FindNextChangeNotification

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
FindCloseChangeNotification
FindFirstChangeNotification

Other Resources

Wait Functions