FindNextChangeNotification
The FindNextChangeNotification
function requests that the operating system signal a change notification handle
the next time it detects an appropriate change.
BOOL FindNextChangeNotification(
|
HANDLE hChangeHandle |
// handle to change
notification to signal |
|
); |
|
Parameters
hChangeHandle
Identifies 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 functionsY2TC_3.
If a change
occurs after a call to FindFirstChangeNotification but before a call to FindNextChangeNotification,
the operating system records the change. When FindNextChangeNotification
is executed, the recorded change immediately satisfies a wait for the change
notification.
FindNextChangeNotification should not be used 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 hChangeHandle
is no longer needed, close it by using the FindCloseChangeNotification
function.
See Also