FILE_FS_CONTROL_INFORMATION-Struktur (ntifs.h)

Die FILE_FS_CONTROL_INFORMATION Struktur wird verwendet, um Steuerelementinformationen für die Dateien in einem Verzeichnis abzufragen oder festzulegen.

Syntax

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;

Member

FreeSpaceStartFiltering

Mindestmenge an freiem Speicherplatz in Bytes, der erforderlich ist, damit der Content-Indexing-Daemon mit der Dokumentfilterung beginnt.

FreeSpaceThreshold

Mindestmenge an freiem Speicherplatz in Bytes, der erforderlich ist, damit der Indizierungsdienst weiterhin Dokumente filtern und Wortlisten zusammenführen kann. Wenn der freie Speicherplatz unter diesen Schwellenwert fällt, wird eine Warnmeldung in das Microsoft Windows Anwendungsereignisprotokoll geschrieben. Das Filtern und Zusammenführen wird angehalten, bis Speicherplatz freigegeben wird.

FreeSpaceStopFiltering

Mindestmenge an freiem Speicherplatz in Byte, der für den Content-Indexing-Daemon erforderlich ist, um die Dokumentfilterung fortzusetzen. Wenn der freie Speicherplatz unter diesen Schwellenwert fällt, wird die Dokumentfilterung angehalten.

DefaultQuotaThreshold

Standardschwellenwert für Kontingentwarnungen pro Benutzer für das Volume.

DefaultQuotaLimit

Standardkontingentgrenze pro Benutzer für das Volume.

FileSystemControlFlags

Bitmaske von Flags, die die Kontingenterzwingung und Protokollierung von benutzerbezogenen Kontingentereignissen auf dem Volume steuern. Bei der Protokollierung wird ein Eintrag im Windows Anwendungsereignisprotokoll angezeigt. Kompatible Kombination aus einer oder mehreren der folgenden:

Dateisystemsteuerungsflag Bedeutung
FILE_VC_CONTENT_INDEX_DISABLED Wenn diese Einstellung festgelegt ist, ist die Inhaltsindizierung deaktiviert.
FILE_VC_LOG_QUOTA_LIMIT Falls festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer sein zugewiesenes Datenträgerkontingentlimit überschreitet.
FILE_VC_LOG_QUOTA_THRESHOLD Falls festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer seinen zugewiesenen Schwellenwert für Kontingentwarnungen überschreitet.
FILE_VC_LOG_VOLUME_LIMIT Wenn diese Einstellung festgelegt ist, wird ein Ereignisprotokolleintrag erstellt, wenn der Grenzwert für den freien Speicherplatz des Volumes überschritten wird.
FILE_VC_LOG_VOLUME_THRESHOLD Wenn diese Einstellung festgelegt ist, wird ein Ereignisprotokolleintrag erstellt, wenn der Schwellenwert für freien Speicherplatz des Volumes überschritten wird.
FILE_VC_QUOTA_ENFORCE Wenn diese Einstellung festgelegt ist, werden Kontingente auf dem Volume erzwungen.
FILE_VC_QUOTA_TRACK Falls festgelegt, werden Kontingente auf dem Volume nachverfolgt.
FILE_VC_QUOTAS_INCOMPLETE Wenn diese Einstellung festgelegt ist, sind die Kontingentinformationen für das Volume unvollständig.
FILE_VC_QUOTAS_REBUILDING Wenn diese Einstellung festgelegt ist, erstellt das Dateisystem die Kontingentinformationen für das Volume neu.

Darüber hinaus werden die folgenden Flagmasken definiert. Diese sind nützlich, um Flagwerte zu testen.

Mask Wert
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 ORed-Kombination aller Flags in der obigen Tabelle.

Hinweise

Diese Informationen können auf eine der folgenden Arten abgefragt werden:

  • Rufen Sie FltQueryVolumeInformation oder ZwQueryVolumeInformationFile auf, und übergeben Sie FileFsControlInformation als Wert von FileInformationClass und einen vom Aufrufer zugeordneten, FILE_FS_CONTROL_INFORMATION strukturierten Puffer als Wert von FileInformation.
  • Erstellen Sie ein IRP mit Hauptfunktionscode IRP_MJ_QUERY_VOLUME_INFORMATION.
FILE_READ_DATA Zugriff auf das Volume ist erforderlich, um diese Informationen abzufragen.

Diese Informationen können auf eine der folgenden Arten festgelegt werden:

  • Rufen Sie FltSetVolumeInformation oder ZwSetVolumeInformationFile auf, und übergeben Sie FileFsControlInformation als Wert von FileInformationClass und einen vom Aufrufer zugeordneten, FILE_FS_CONTROL_INFORMATION strukturierten Puffer als Wert von FileInformation.
  • Erstellen Sie ein IRP mit Hauptfunktionscode IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA Zugriff auf das Volume ist erforderlich, um diese Informationen festzulegen.

Die Größe des Puffers, der im FileInformation-Parameter an FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile oder ZwSetVolumeInformationFile übergeben wird, muss mindestens sizeof (FILE_FS_CONTROL_INFORMATION) sein.

Diese Struktur muss an einer LONGLONG-Grenze (8 Byte) ausgerichtet sein.

Anforderungen

   
Kopfzeile ntifs.h (include Ntifs.h, Fltkernel.h)

Weitere Informationen:

FltQueryVolumeInformation

FltSetVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

IRP_MJ_SET_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

ZwSetVolumeInformationFile