FindNextChangeNotification 函数 (fileapi.h)
请求操作系统在下次检测到相应更改时,发出更改通知句柄信号。
语法
BOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
参数
[in] hChangeHandle
由 FindFirstChangeNotification 函数创建的更改通知句柄的句柄。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
在 FindNextChangeNotification 函数成功返回后,应用程序可以使用 wait 函数等待发生更改的通知。
如果在调用 FindFirstChangeNotification 之后但在调用 FindNextChangeNotification 之前发生更改,则操作系统会记录更改。 执行 FindNextChangeNotification 时,记录的更改会立即满足等待更改通知。
每次成功调用 FindNextChangeNotification 后,都必须调用其中一个等待函数。 如果 wait 函数返回的原因除 (发出信号的更改通知句柄之外的任何原因,例如,如果等待超时) ,则应用程序必须重试等待。 未能遵循此规则可能会导致系统最终耗尽资源。 它还可能导致应用程序错过某些更改通知。
如果不再需要 hChangeHandle ,请使用 FindCloseChangeNotification 函数将其关闭。
在 Windows 8 和 Windows Server 2012 中,此函数由以下技术支持。
技术 | 支持 |
---|---|
服务器消息块 (SMB) 3.0 协议 | 是 |
SMB 3.0 透明故障转移 (TFO) | 是 |
具有横向扩展文件共享的 SMB 3.0 (SO) | 是 |
群集共享卷文件系统 (CSV) | 查看备注 |
弹性文件系统 (ReFS) | 是 |
应用程序可能会在 CsvF 暂停/恢复时遇到误报。
示例
有关示例,请参阅 获取目录更改通知。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | fileapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |