struktur DELETE_USN_JOURNAL_DATA (winioctl.h)

Artikel
03/09/2024

Berisi informasi tentang penghapusan jurnal perubahan nomor urutan pembaruan (USN) menggunakan kode kontrol FSCTL_DELETE_USN_JOURNAL .

Sintaks

typedef struct {
  DWORDLONG UsnJournalID;
  DWORD     DeleteFlags;
} DELETE_USN_JOURNAL_DATA, *PDELETE_USN_JOURNAL_DATA;

Anggota

UsnJournalID

Pengidentifikasi jurnal perubahan yang akan dihapus.

Jika jurnal aktif dan penghapusan diminta dengan mengatur bendera USN_DELETE_FLAG_DELETE di anggota DeleteFlags , maka pengidentifikasi ini harus menentukan jurnal perubahan untuk volume saat ini. Gunakan FSCTL_QUERY_USN_JOURNAL untuk mengambil pengidentifikasi jurnal perubahan ini. Jika dalam hal ini pengidentifikasi bukan untuk jurnal perubahan volume saat ini, FSCTL_DELETE_USN_JOURNAL gagal.

Jika pemberitahuan alih-alih penghapusan diminta dengan mengatur hanya bendera USN_DELETE_FLAG_NOTIFY di DeleteFlags, UsnJournalID diabaikan.

DeleteFlags

Menunjukkan apakah penghapusan atau pemberitahuan mengenai penghapusan dilakukan, atau keduanya. Anggota DeleteFlags harus berisi satu atau kedua nilai berikut.

Nilai	Makna
USN_DELETE_FLAG_DELETE 0x00000001	Jika bendera ini diatur dan bendera USN_DELETE_FLAG_NOTIFY tidak diatur, operasi FSCTL_DELETE_USN_JOURNAL memulai proses penghapusan jurnal dan segera kembali. Proses penghapusan jurnal berlanjut, jika perlu, di seluruh sistem dimulai ulang. Jika bendera ini diatur dan bendera USN_DELETE_FLAG_NOTIFY juga diatur, penghapusan dan pemberitahuan terjadi. Jika bendera ini diatur dan jurnal aktif, Anda harus memberikan pengidentifikasi untuk jurnal perubahan untuk volume saat ini di UsnJournalID atau operasi gagal. Jika jurnal tidak aktif, maka UsnJournalID diabaikan dan jurnal dihapus.
USN_DELETE_FLAG_NOTIFY 0x00000002	Jika bendera ini diatur, panggilan akan menyiapkan pemberitahuan tentang kapan penghapusan selesai. Permintaan penghapusan jurnal selesai ketika proses penghapusan jurnal selesai. Jika bendera ini diatur dan bendera USN_DELETE_FLAG_DELETE tidak diatur, maka panggilan menyiapkan pemberitahuan penghapusan yang mungkin sudah berlangsung. Misalnya, saat aplikasi Anda dimulai, aplikasi mungkin menggunakan bendera ini untuk menentukan apakah penghapusan sedang berlangsung. Jika bendera ini diatur dan bendera USN_DELETE_FLAG_DELETE juga diatur, penghapusan dan pemberitahuan terjadi. Pemberitahuan dilakukan menggunakan port penyelesaian I/O atau mekanisme lain untuk pemberitahuan peristiwa asinkron.

Nilai

Makna

USN_DELETE_FLAG_DELETE
0x00000001

Jika bendera ini diatur dan bendera USN_DELETE_FLAG_NOTIFY tidak diatur, operasi FSCTL_DELETE_USN_JOURNAL memulai proses penghapusan jurnal dan segera kembali. Proses penghapusan jurnal berlanjut, jika perlu, di seluruh sistem dimulai ulang.

Jika bendera ini diatur dan bendera USN_DELETE_FLAG_NOTIFY juga diatur, penghapusan dan pemberitahuan terjadi. Jika bendera ini diatur dan jurnal aktif, Anda harus memberikan pengidentifikasi untuk jurnal perubahan untuk volume saat ini di UsnJournalID atau operasi gagal. Jika jurnal tidak aktif, maka UsnJournalID diabaikan dan jurnal dihapus.

USN_DELETE_FLAG_NOTIFY
0x00000002

Jika bendera ini diatur, panggilan akan menyiapkan pemberitahuan tentang kapan penghapusan selesai. Permintaan penghapusan jurnal selesai ketika proses penghapusan jurnal selesai. Jika bendera ini diatur dan bendera USN_DELETE_FLAG_DELETE tidak diatur, maka panggilan menyiapkan pemberitahuan penghapusan yang mungkin sudah berlangsung. Misalnya, saat aplikasi Anda dimulai, aplikasi mungkin menggunakan bendera ini untuk menentukan apakah penghapusan sedang berlangsung.

Jika bendera ini diatur dan bendera USN_DELETE_FLAG_DELETE juga diatur, penghapusan dan pemberitahuan terjadi. Pemberitahuan dilakukan menggunakan port penyelesaian I/O atau mekanisme lain untuk pemberitahuan peristiwa asinkron.

Keterangan

Untuk informasi selengkapnya, lihat Membuat, Memodifikasi, dan Menghapus Journal Perubahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)

Lihat juga

FSCTL_DELETE_USN_JOURNAL

FSCTL_QUERY_USN_JOURNAL

Bagikan melalui