struktur FILE_FS_CONTROL_INFORMATION (ntifs.h)

Artikel
09/27/2023

Struktur FILE_FS_CONTROL_INFORMATION digunakan untuk mengkueri atau mengatur informasi kontrol untuk file dalam direktori.

Sintaks

typedef struct _FILE_FS_CONTROL_INFORMATION {
  LARGE_INTEGER FreeSpaceStartFiltering;
  LARGE_INTEGER FreeSpaceThreshold;
  LARGE_INTEGER FreeSpaceStopFiltering;
  LARGE_INTEGER DefaultQuotaThreshold;
  LARGE_INTEGER DefaultQuotaLimit;
  ULONG         FileSystemControlFlags;
} FILE_FS_CONTROL_INFORMATION, *PFILE_FS_CONTROL_INFORMATION;

Anggota

FreeSpaceStartFiltering

Jumlah minimum ruang disk kosong, dalam byte, yang diperlukan agar daemon Pengindeksan Konten memulai pemfilteran dokumen.

FreeSpaceThreshold

Jumlah minimum ruang disk kosong, dalam byte, yang diperlukan agar Layanan Pengindeksan terus memfilter dokumen dan menggabungkan daftar kata. Jika jumlah ruang disk kosong berada di bawah ambang batas ini, pesan peringatan ditulis ke log peristiwa aplikasi Microsoft Windows. Pemfilteran dan penggabungan dihentikan hingga ruang dibebaskan.

FreeSpaceStopFiltering

Jumlah minimum ruang disk kosong, dalam byte, yang diperlukan agar daemon Pengindeksan Konten melanjutkan pemfilteran dokumen. Jika jumlah ruang disk kosong berada di bawah ambang batas ini, pemfilteran dokumen dihentikan.

DefaultQuotaThreshold

Ambang peringatan kuota disk per pengguna default untuk volume.

DefaultQuotaLimit

Batas kuota disk per pengguna default untuk volume.

FileSystemControlFlags

Bitmask bendera yang mengontrol penegakan kuota dan pengelogan peristiwa kuota terkait pengguna pada volume. Pengelogan membuat entri di log peristiwa aplikasi Windows. Kombinasi yang kompatibel dari satu atau beberapa hal berikut ini:

Bendera Kontrol Sistem File	Makna
FILE_VC_CONTENT_INDEX_DISABLED	Jika diatur, pengindeksan konten dinonaktifkan.
FILE_VC_LOG_QUOTA_LIMIT	Jika diatur, entri log peristiwa akan dibuat ketika pengguna melebihi batas kuota disk yang ditetapkan.
FILE_VC_LOG_QUOTA_THRESHOLD	Jika diatur, entri log peristiwa akan dibuat ketika pengguna melebihi ambang peringatan kuota yang ditetapkan.
FILE_VC_LOG_VOLUME_LIMIT	Jika diatur, entri log peristiwa akan dibuat ketika batas ruang kosong volume terlampaui.
FILE_VC_LOG_VOLUME_THRESHOLD	Jika diatur, entri log peristiwa akan dibuat ketika ambang ruang kosong volume terlampaui.
FILE_VC_QUOTA_ENFORCE	Jika diatur, kuota diberlakukan pada volume.
FILE_VC_QUOTA_TRACK	Jika diatur, kuota dilacak pada volume.
FILE_VC_QUOTAS_INCOMPLETE	Jika diatur, informasi kuota untuk volume tidak lengkap.
FILE_VC_QUOTAS_REBUILDING	Jika diatur, sistem file sedang membangun kembali informasi kuota untuk volume.

Selain itu, masker bendera berikut didefinisikan. Ini berguna untuk menguji nilai bendera.

Mask	Nilai
FILE_VC_QUOTA_MASK	FILE_VC_QUOTA_ENFORCE \| FILE_VC_QUOTA_TRACK
FILE_VC_QUOTA_NONE	~FILE_VC_QUOTA_ENFORCE & ~FILE_VC_QUOTA_TRACK
FILE_VC_VALID_MASK	Kombinasi ORed dari semua bendera dalam tabel di atas.

Keterangan

Informasi ini dapat dikueri dengan salah satu cara berikut:

Panggil FltQueryVolumeInformation atau ZwQueryVolumeInformationFile, meneruskan FileFsControlInformation sebagai nilai FileInformationClass dan melewati buffer yang dialokasikan pemanggil, FILE_FS_CONTROL_INFORMATION terstruktur sebagai nilai FileInformation.
Buat IRP dengan kode fungsi utama IRP_MJ_QUERY_VOLUME_INFORMATION.

FILE_READ_DATA akses ke volume diperlukan untuk mengkueri informasi ini.

Informasi ini dapat diatur dengan salah satu cara berikut:

Panggil FltSetVolumeInformation atau ZwSetVolumeInformationFile, meneruskan FileFsControlInformation sebagai nilai FileInformationClass dan melewati buffer yang dialokasikan pemanggil, FILE_FS_CONTROL_INFORMATION terstruktur sebagai nilai FileInformation.
Buat IRP dengan kode fungsi utama IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA akses ke volume diperlukan untuk mengatur informasi ini.

Ukuran buffer yang diteruskan dalam parameter FileInformation ke FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile, atau ZwSetVolumeInformationFile harus setidaknya sizeof (FILE_FS_CONTROL_INFORMATION).

Struktur ini harus diselaraskan pada batas LONGLONG (8-byte).