Fungsi FindFirstChangeNotificationA (fileapi.h)
Membuat handel pemberitahuan perubahan dan menyiapkan kondisi filter pemberitahuan perubahan awal. Penantian pada handel pemberitahuan berhasil ketika perubahan yang cocok dengan kondisi filter terjadi di direktori atau subtree yang ditentukan. Fungsi tidak melaporkan perubahan pada direktori yang ditentukan itu sendiri.
Fungsi ini tidak menunjukkan perubahan yang memenuhi kondisi tunggu. Untuk mengambil informasi tentang perubahan tertentu sebagai bagian dari pemberitahuan, gunakan
Fungsi ReadDirectoryChangesW .
Sintaks
HANDLE FindFirstChangeNotificationA(
[in] LPCSTR lpPathName,
[in] BOOL bWatchSubtree,
[in] DWORD dwNotifyFilter
);
Parameter
[in] lpPathName
Jalur lengkap direktori yang akan diawasi.
Ini tidak boleh berupa jalur relatif atau string kosong.
Secara default, namanya terbatas pada MAX_PATH karakter. Untuk memperpanjang batas ini menjadi 32.767 karakter lebar, tambahkan "\\?\" ke jalur. Untuk informasi selengkapnya, lihat Menamai File, Jalur, dan Namespace.
Tip
Dimulai dengan Windows 10, Versi 1607, Anda dapat memilih untuk menghapus batasan MAX_PATH tanpa menambahkan sebelumnya "\\?\". Lihat bagian "Batasan Panjang Jalur Maksimum" di Penamaan File, Jalur, dan Namespace untuk detailnya.
[in] bWatchSubtree
Jika parameter ini TRUE, fungsi memantau pohon direktori yang berakar pada direktori yang ditentukan; jika FALSE, itu hanya memantau direktori yang ditentukan.
[in] dwNotifyFilter
Kondisi filter yang memenuhi pemberitahuan perubahan menunggu. Parameter ini bisa menjadi satu atau beberapa nilai berikut.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah handel untuk menemukan objek pemberitahuan perubahan.
Jika fungsi gagal, nilai yang dikembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi tunggu dapat memantau direktori atau subtree yang ditentukan dengan menggunakan handel yang dikembalikan oleh fungsi FindFirstChangeNotification. Penantian terpenuhi ketika salah satu kondisi filter terjadi di direktori atau subtree yang dipantau.
Setelah penantian terpenuhi, aplikasi dapat merespons kondisi ini dan terus memantau direktori dengan memanggil fungsi FindNextChangeNotification dan fungsi tunggu yang sesuai. Ketika handel tidak lagi diperlukan, handel dapat ditutup dengan menggunakan fungsi FindCloseChangeNotification .
Pemberitahuan mungkin tidak dikembalikan saat memanggil FindFirstChangeNotification untuk sistem file jarak jauh.
Perilaku tautan simbolis—Jika jalur menunjuk ke tautan simbolis, handel pemberitahuan dibuat untuk target.
Jika aplikasi telah mendaftar untuk menerima pemberitahuan perubahan untuk direktori yang berisi tautan simbolis, aplikasi hanya diberi tahu ketika tautan simbolis telah diubah, bukan file target.
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 Berbagi File Peluasan Skala (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 Change_Notifications Direktori.
Catatan
Header fileapi.h mendefinisikan FindFirstChangeNotification sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
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 |