FILE_FS_CONTROL_INFORMATION-Struktur (ntifs.h)

Artikel
10/04/2023

Die FILE_FS_CONTROL_INFORMATION-Struktur wird verwendet, um Steuerungsinformationen 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 des freien Speicherplatzes in Bytes, der erforderlich ist, damit der Content-Indexing-Daemon mit der Dokumentfilterung beginnen kann.

FreeSpaceThreshold

Mindestmenge des freien Speicherplatzes (in Bytes), der für den Indizierungsdienst erforderlich ist, um weiterhin Dokumente zu filtern und Wortlisten zusammenzuführen. Wenn der freie Speicherplatz unter diesen Schwellenwert fällt, wird eine Warnmeldung in das Ereignisprotokoll der Microsoft Windows-Anwendung geschrieben. Das Filtern und Zusammenführen wird angehalten, bis speicherplatzfrei ist.

FreeSpaceStopFiltering

Mindestmenge des freien Speicherplatzes (in Bytes), 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 das Datenträgerkontingent pro Benutzer für das Volume.

DefaultQuotaLimit

Standardmäßiges Datenträgerkontingentlimit pro Benutzer für das Volume.

FileSystemControlFlags

Bitmaske von Flags, die die Kontingenterzwingung und Protokollierung benutzerbezogener Kontingentereignisse auf dem Volume steuern. Die Protokollierung erstellt einen Eintrag im Ereignisprotokoll der Windows-Anwendung. Kompatible Kombination aus mindestens einer der folgenden Optionen:

Dateisystemsteuerungsflagge	Bedeutung
FILE_VC_CONTENT_INDEX_DISABLED	Wenn festgelegt, ist die Inhaltsindizierung deaktiviert.
FILE_VC_LOG_QUOTA_LIMIT	Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer sein zugewiesenes Datenträgerkontingentlimit überschreitet.
FILE_VC_LOG_QUOTA_THRESHOLD	Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer seinen zugewiesenen Schwellenwert für Kontingentwarnungen überschreitet.
FILE_VC_LOG_VOLUME_LIMIT	Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn das Freiraumlimit des Volumes überschritten wird.
FILE_VC_LOG_VOLUME_THRESHOLD	Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Schwellenwert für freien Speicherplatz des Volumes überschritten wird.
FILE_VC_QUOTA_ENFORCE	Wenn festgelegt, werden Kontingente auf dem Volume erzwungen.
FILE_VC_QUOTA_TRACK	Wenn festgelegt, werden Kontingente auf dem Volume nachverfolgt.
FILE_VC_QUOTAS_INCOMPLETE	Falls festgelegt, sind die Kontingentinformationen für das Volume unvollständig.
FILE_VC_QUOTAS_REBUILDING	Falls festgelegt, 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, übergeben Sie FileFsControlInformation als Wert von FileInformationClass und übergeben Sie einen aufruferseitig zugeordneten, FILE_FS_CONTROL_INFORMATION strukturierten Puffer als Wert von FileInformation.
Erstellen Sie eine 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, übergeben Sie FileFsControlInformation als Wert von FileInformationClass , und übergeben Sie einen aufruferseitig zugewiesenen, 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 werden.