struktur MARK_HANDLE_INFO32 (winioctl.h)

Berisi informasi yang digunakan untuk menandai file atau direktori tertentu, dan nomor urutan pembaruannya (USN) mengubah catatan jurnal dengan data tentang perubahan. Ini hanya didefinisikan untuk kode 64-bit dan ada untuk menafsirkan struktur MARK_HANDLE_INFO yang dikirim oleh kode 32-bit. Ini digunakan oleh kode kontrol IOCTL FSCTL_MARK_HANDLE .

Sintaks

typedef struct _MARK_HANDLE_INFO32 {
  union {
    DWORD UsnSourceInfo;
    DWORD CopyNumber;
  } DUMMYUNIONNAME;
  DWORD  UsnSourceInfo;
  UINT32 VolumeHandle;
  DWORD  HandleInfo;
} MARK_HANDLE_INFO32, *PMARK_HANDLE_INFO32;

Anggota

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

DUMMYUNIONNAME.CopyNumber

UsnSourceInfo

Jenis perubahan yang sedang dilakukan.

Operasi tidak mengubah file atau direktori secara eksternal dari sudut pandang aplikasi yang membuatnya.

Saat utas menulis catatan USN baru, informasi sumber ditandai dalam catatan sebelumnya terus ada hanya jika utas juga mengatur bendera tersebut. Oleh karena itu, struktur informasi sumber memungkinkan aplikasi untuk memfilter rekaman USN yang hanya ditetapkan oleh sumber yang diketahui, seperti filter antivirus.

Nilai berikut didefinisikan.

Nilai	Makna
USN_SOURCE_DATA_MANAGEMENT 0x00000001	Operasi ini menyediakan informasi tentang perubahan pada file atau direktori yang dibuat oleh sistem operasi. Penggunaan umum adalah ketika Penyimpanan Jarak Jauh memindahkan data dari penyimpanan eksternal ke lokal. Penyimpanan Jarak Jauh adalah perangkat lunak manajemen penyimpanan hierarkis. Langkah seperti itu biasanya minimal menambahkan bendera USN_REASON_DATA_OVERWRITE ke rekaman USN. Namun, data tidak berubah dari sudut pandang pengguna. Dengan mencatat USN_SOURCE_DATA_MANAGEMENT di anggota SourceInfo dari struktur USN_RECORD yang menyimpan rekaman, Anda dapat menentukan bahwa meskipun operasi tulis dilakukan pada item, data tidak berubah.
USN_SOURCE_AUXILIARY_DATA 0x00000002	Operasi menambahkan aliran data privat ke file atau direktori. Contohnya mungkin detektor virus yang menambahkan informasi checksum. Saat detektor virus memodifikasi item, sistem menghasilkan catatan USN. USN_SOURCE_AUXILIARY_DATA menunjukkan bahwa modifikasi tidak mengubah data aplikasi.
USN_SOURCE_REPLICATION_MANAGEMENT 0x00000004	Operasi membuat atau memperbarui konten file yang direplikasi. Misalnya, layanan replikasi file mengatur bendera ini saat membuat atau memperbarui file dalam direktori yang direplikasi.

VolumeHandle

Handel volume ke volume tempat file atau direktori berada. Untuk informasi selengkapnya tentang mendapatkan handel volume, lihat bagian Keterangan.

Handel ini diperlukan untuk memeriksa hak istimewa untuk operasi ini.

Penelepon harus memiliki hak istimewa SE_MANAGE_VOLUME_NAME . Untuk informasi selengkapnya, lihat Hak Istimewa.

HandleInfo

Bendera yang menentukan informasi tambahan tentang file atau direktori yang diidentifikasi oleh nilai handel di anggota VolumeHandle .

Nilai	Makna
MARK_HANDLE_PROTECT_CLUSTERS 0x00000001	File ditandai sebagai tidak dapat didefragmentasi hingga handel ditutup.
MARK_HANDLE_TXF_SYSTEM_LOG 0x00000004	File ditandai sebagai tidak dapat didefragmentasi hingga handel ditutup.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG 0x00000008	File ditandai sebagai tidak dapat didefragmentasi hingga handel ditutup.
MARK_HANDLE_REALTIME 0x00000020	File ditandai untuk perilaku baca real time terlepas dari jenis file yang sebenarnya. File yang ditandai dengan bendera ini harus dibuka untuk I/O yang tidak dibuffer.
MARK_HANDLE_NOT_REALTIME 0x00000040	File yang sebelumnya ditandai untuk perilaku baca real time menggunakan bendera MARK_HANDLE_REALTIME dapat tidak ditandai menggunakan bendera ini, menghapus perilaku real-time. File yang ditandai dengan bendera ini harus dibuka untuk I/O yang tidak dibuffer.

Persyaratan

Klien minimum yang didukung	Windows 8 (hanya 64-bit) [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)