FILE_FS_CONTROL_INFORMATION Struktur (ntifs.h)

Artikel
12/21/2024

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;

Angehörige

FreeSpaceStartFiltering

Mindestmenge an freiem Speicherplatz in Bytes, die für den Inhaltsindizierungsdaemon erforderlich ist, um mit der Dokumentfilterung zu beginnen.

FreeSpaceThreshold

Mindestmenge an freiem Speicherplatz in Byte, 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 Speicherplatz freigegeben wird.

FreeSpaceStopFiltering

Mindestmenge an freiem Speicherplatz in Bytes, die für den Inhaltsindizierungsdaemon erforderlich ist, um die Dokumentfilterung fortzusetzen. Wenn der freie Speicherplatz unter diesen Schwellenwert fällt, wird die Dokumentfilterung angehalten.

DefaultQuotaThreshold

Standardmäßiger Kontingentwarnungsschwellenwert pro Benutzer für das Volume.

DefaultQuotaLimit

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

FileSystemControlFlags

Bitmaske von Flags, die die Erzwingung von Kontingenten und die Protokollierung von benutzerbezogenen Kontingentereignissen auf dem Volume steuern. Durch die Protokollierung wird ein Eintrag im Ereignisprotokoll der Windows-Anwendung erstellt. Kompatible Kombination aus einer oder mehreren der folgenden Optionen:

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

Darüber hinaus werden die folgenden Kennzeichnungsmasken definiert. Dies ist nützlich zum Testen von Flagwerten.

Maske	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	Ausgelassene Kombination aller Flags in der obigen Tabelle.

Bemerkungen

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

Rufen Sie FltQueryVolumeInformation oder ZwQueryVolumeInformationFileauf, und übergeben Sie FileFsControlInformation als Wert von FileInformationClass und übergeben Sie einen 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 ZwSetVolumeInformationFileauf, und übergeben Sie FileFsControlInformation als Wert von FileInformationClass und übergeben Sie einen zugeordneten Aufrufer, 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 im FileInformation Parameter übergebenen Puffers an FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFileoder ZwSetVolumeInformationFile muss mindestens Größe (FILE_FS_CONTROL_INFORMATION) sein.

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