struktur FILE_FS_CONTROL_INFORMATION (ntifs.h)

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 dikosongkan.

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 batas 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 meneruskan 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).

Persyaratan

   
Header ntifs.h (termasuk Ntifs.h, Fltkernel.h)

Lihat juga

FltQueryVolumeInformation

FltSetVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

IRP_MJ_SET_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

ZwSetVolumeInformationFile