Requests that the operating system signal a change notification handle the next time it detects an appropriate change.
SyntaxBOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
Parameters
[in] hChangeHandle
A handle to a change notification handle created by the FindFirstChangeNotification function.
Return valueIf the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
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 operating system records the change. When FindNextChangeNotification is executed, the recorded change immediately satisfies a wait for the change notification.
Each successful call to FindNextChangeNotification must be followed by a call to one of the wait functions. If the wait function returns for any reason other than the change notification handle being signaled (for example, if the wait times out), the application must retry the wait. Failing to follow this rule can cause the system to eventually run out of resources. It can also cause the application to miss some change notifications.
When hChangeHandle is no longer needed, close it by using the FindCloseChangeNotification function.
In Windows 8 and Windows Server 2012, this function is supported by the following technologies.
Technology Supported Server Message Block (SMB) 3.0 protocol Yes SMB 3.0 Transparent Failover (TFO) Yes SMB 3.0 with Scale-out File Shares (SO) Yes Cluster Shared Volume File System (CsvFS) See remark Resilient File System (ReFS) YesApplication might experience false positives on CsvFs pause/resume.
ExamplesFor an example, see Obtaining Directory Change Notifications.
Requirements Requirement Value Minimum supported client Windows XP [desktop apps only] Minimum supported server Windows Server 2003 [desktop apps only] Target Platform Windows Header fileapi.h (include Windows.h) Library Kernel32.lib DLL Kernel32.dll See alsoDirectory Management Functions
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4