Fungsi FindNextChangeNotification (fileapi.h)
Meminta agar sistem operasi memberi sinyal pemberitahuan perubahan menangani saat berikutnya mendeteksi perubahan yang sesuai.
Sintaks
BOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
Parameter
[in] hChangeHandle
Handel ke handel pemberitahuan perubahan yang dibuat oleh fungsi FindFirstChangeNotification .
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Setelah fungsi FindNextChangeNotification berhasil dikembalikan, aplikasi dapat menunggu pemberitahuan bahwa perubahan telah terjadi dengan menggunakan fungsi tunggu.
Jika perubahan terjadi setelah panggilan ke FindFirstChangeNotification tetapi sebelum panggilan ke FindNextChangeNotification, sistem operasi merekam perubahan. Ketika FindNextChangeNotification dijalankan, perubahan yang direkam segera memenuhi tunggu pemberitahuan perubahan.
Setiap panggilan yang berhasil ke FindNextChangeNotification harus diikuti dengan panggilan ke salah satu fungsi tunggu. Jika fungsi tunggu kembali karena alasan apa pun selain handel pemberitahuan perubahan yang diberi sinyal (misalnya, jika waktu tunggu habis), aplikasi harus mencoba kembali menunggu. Gagal mengikuti aturan ini dapat menyebabkan sistem akhirnya kehabisan sumber daya. Ini juga dapat menyebabkan aplikasi melewatkan beberapa pemberitahuan perubahan.
Ketika hChangeHandle tidak lagi diperlukan, tutup dengan menggunakan fungsi FindCloseChangeNotification .
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
Teknologi | Didukung |
---|---|
Protokol Server Message Block (SMB) 3.0 | Ya |
SMB 3.0 Transparent Failover (TFO) | Ya |
SMB 3.0 dengan Scale-out File Shares (SO) | Ya |
Sistem File Volume Bersama Kluster (CsvFS) | Lihat keterangan |
Sistem File Tangguh (ReFS) | Ya |
Aplikasi mungkin mengalami positif palsu pada CsvF jeda/lanjutkan.
Contoh
Misalnya, lihat Mendapatkan Pemberitahuan Perubahan Direktori.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | fileapi.h (sertakan Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |