FindNextChangeNotification

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

BOOL FindNextChangeNotification(
  HANDLE hChangeHandle
);

Parameters

• hChangeHandle
  [in] Handle to a change notification handle created by the FindFirstChangeNotification function.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

After the FindNextChangeNotification 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 FindNextChangeNotification, the OS records the change. When FindNextChangeNotification is executed, the recorded change immediately satisfies a wait for the change notification.

You should not use FindNextChangeNotification more than once on the same handle without using one of the wait functions. An application may miss a change notification if it uses FindNextChangeNotification when there is a change request outstanding.

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Winbase.h.
Link Library: Coredll.lib.

See Also

Wait Functions | FindCloseChangeNotification | FindFirstChangeNotification

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.