FindNextChangeNotification 函式 (fileapi.h)
要求操作系統在下次偵測到適當的變更時發出變更通知的訊號。
語法
BOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
參數
[in] hChangeHandle
FindFirstChangeNotification 函式所建立之變更通知句柄的句柄。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
在 FindNextChangeNotification 函式成功傳回之後,應用程式可以使用等候函式來等候已發生變更的通知。
如果在呼叫 FindFirstChangeNotification 之後發生變更,但在呼叫 FindNextChangeNotification 之前,操作系統會記錄變更。 執行 FindNextChangeNotification 時,記錄的變更會立即滿足變更通知的等候。
每次成功呼叫 FindNextChangeNotification 時,都必須接著呼叫其中一個等候函式。 例如,如果等候函式因變更通知句柄發出 (訊號以外的任何原因而傳回,例如,如果等候逾時) ,應用程式必須重試等候。 無法遵循此規則可能會導致系統最終用盡資源。 這也可能會導致應用程式遺漏一些變更通知。
不再需要 hChangeHandle 時,請使用 FindCloseChangeNotification 函式將其關閉。
在 Windows 8 和 Windows Server 2012 中,下列技術支援此函式。
技術 | 支援 |
---|---|
伺服器消息塊 (SMB) 3.0 通訊協定 | Yes |
SMB 3.0 透明故障轉移 (TFO) | Yes |
具有向外延展檔案共用的SMB 3.0 (SO) | Yes |
叢集共用磁碟區文件系統 (CsvFS) | 請參閱備註 |
彈性檔案系統 (ReFS) | Yes |
應用程式可能會在 CsvFs 暫停/繼續時遇到誤判。
範例
如需範例,請參閱 取得目錄變更通知。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | fileapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |