struktur FILE_NOTIFY_INFORMATION (ntifs.h)
FILE_NOTIFY_INFORMATION menjelaskan perubahan pada direktori. Ini dikembalikan sebagai respons terhadap permintaan IRP_MJ_DIRECTORY_CONTROL dengan kode fungsi minor IRP_MN_NOTIFY_CHANGE_DIRECTORY saat DIRECTORY_NOTIFY_INFORMATION_CLASS adalah DirectoryNotifyInformation.
Sintaks
typedef struct _FILE_NOTIFY_INFORMATION {
ULONG NextEntryOffset;
ULONG Action;
ULONG FileNameLength;
WCHAR FileName[1];
} FILE_NOTIFY_INFORMATION, *PFILE_NOTIFY_INFORMATION;
Anggota
NextEntryOffset
Jumlah byte yang harus dilewati untuk masuk ke rekaman berikutnya. Nilai nol menunjukkan bahwa ini adalah rekaman terakhir.
Action
Jenis perubahan yang telah terjadi. Anggota ini bisa menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
| FILE_ACTION_ADDED (0x00000001) | File ditambahkan ke direktori. |
| FILE_ACTION_REMOVED (0x00000002) | File telah dihapus dari direktori. |
| FILE_ACTION_MODIFIED (0x00000003) | File dimodifikasi. Ini bisa menjadi perubahan dalam stempel waktu atau atribut. |
| FILE_ACTION_RENAMED_OLD_NAME (0x00000004) | Berkas diganti namanya dan ini adalah nama lama. |
| FILE_ACTION_RENAMED_NEW_NAME (0x00000005) | Berkas diganti namanya dan ini adalah nama baru. |
| FILE_ACTION_ADDED_STREAM (0x00000006) | Aliran bernama ditambahkan ke file. |
| FILE_ACTION_REMOVED_STREAM (0x00000007) | Aliran bernama dihapus dari file. |
| FILE_ACTION_MODIFIED_STREAM (0x00000008) | Aliran bernama telah dimodifikasi. Modifikasi dapat menjadi perubahan pada data atau atribut aliran bernama. |
| FILE_ACTION_REMOVED_BY_DELETE (0x00000009) | ID objek dihapus karena file yang dirujuk ID objek telah dihapus. Pemberitahuan ini hanya dikirim ketika direktori yang dipantau adalah direktori khusus "$Extend$ObjId:$O:$INDEX_ALLOCATION". |
| FILE_ACTION_ID_NOT_TUNNELLED (0x0000000A) | Upaya untuk tunnel informasi ID objek ke file yang sedang dibuat atau diganti namanya gagal karena ID objek sedang digunakan oleh file lain pada volume yang sama. Pemberitahuan ini hanya dikirim ketika direktori yang dipantau adalah direktori khusus "$Extend$ObjId:$O:$INDEX_ALLOCATION". |
| FILE_ACTION_TUNNELLED_ID_COLLISION (0x0000000B) | Upaya untuk membuat terowongan informasi ID objek ke file yang diganti namanya gagal karena file sudah memiliki ID objek. Pemberitahuan ini hanya dikirim ketika direktori yang dipantau adalah direktori khusus "$Extend$ObjId:$O:$INDEX_ALLOCATION". |
FileNameLength
Ukuran bagian nama file dari rekaman, dalam byte. Nilai ini tidak termasuk karakter null yang mengakhiri.
FileName[1]
Bidang panjang variabel yang berisi nama file relatif terhadap handel direktori. Nama file dalam format karakter Unicode dan tidak dihentikan null.
Jika ada nama pendek dan panjang untuk file, hanya salah satu nama ini yang akan dikembalikan, tetapi tidak ditentukan yang mana.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10 |
| Header | ntifs.h |