FILE_FS_CONTROL_INFORMATION Struktur (ntifs.h)

Die FILE_FS_CONTROL_INFORMATION-Struktur wird zum Abfragen oder Festlegen von Steuerelementinformationen für die Dateien in einem Verzeichnis verwendet.

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 freier Speicherplatz in Bytes, die für den Content-Indexing-Daemon erforderlich ist, um mit der Dokumentfilterung zu beginnen.

FreeSpaceThreshold

Mindestmenge freier Speicherplatz, in Bytes, erforderlich für den Indexingdienst, um weiterhin Dokumente zu filtern und Wortlisten zusammenzuführen. Wenn der speicherplatzfreie Speicherplatz unter diesem Schwellenwert fällt, wird eine Warnungsmeldung in das Microsoft Windows-Anwendungsereignisprotokoll geschrieben. Die Filterung und Zusammenführung wird beendet, bis speicherplatzfrei ist.

FreeSpaceStopFiltering

Mindestmenge freier Speicherplatz in Bytes, die für den Content-Indexing-Daemon erforderlich ist, um die Dokumentfilterung fortzusetzen. Wenn der speicherplatzfreie Speicherplatz unter diesem Schwellenwert fällt, wird die Dokumentfilterung beendet.

DefaultQuotaThreshold

Standardschwellenwert für datenträgerkontingente Warnungsschwellenwerte für das Volume.

DefaultQuotaLimit

Standardlimit pro Benutzerdatenkontingent für das Volume.

FileSystemControlFlags

Bitmask von Flags, die die Kontingenterzwingung und Protokollierung von benutzerbezogenen Kontingentereignissen auf dem Volume steuern. Die Protokollierung macht einen Eintrag im Windows-Anwendungsereignisprotokoll. Kompatibel mit einer oder mehreren der folgenden Kombinationen:

Dateisystemsteuerelement-Flag Bedeutung
FILE_VC_CONTENT_INDEX_DISABLED Wenn festgelegt, ist die Inhaltsindexierung deaktiviert.
FILE_VC_LOG_QUOTA_LIMIT Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer seine zugewiesene Datenträgerkontingentgrenze überschreitet.
FILE_VC_LOG_QUOTA_THRESHOLD Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer seinen zugewiesenen Kontingentwarnungsschwellenwert überschreitet.
FILE_VC_LOG_VOLUME_LIMIT Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn die Leergrenze des Volumens überschritten wird.
FILE_VC_LOG_VOLUME_THRESHOLD Wenn festgelegt, wird ein Ereignisprotokolleintrag erstellt, wenn der Freiraumschwellenwert 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 Wenn festgelegt, ist die Kontingentinformationen für das Volume unvollständig.
FILE_VC_QUOTAS_REBUILDING Wenn festgelegt, erstellt das Dateisystem die Kontingentinformationen für das Volume neu.
 

Darüber hinaus werden die folgenden Flag-Masken definiert. Dies ist nützlich für das Testen von Flagwerten.

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.

Bemerkungen

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 einen anrufer zugewiesenen, 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, ü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, ZwQueryVolumeInformationFile oder ZwSetVolumeInformationFile muss mindestens größeof (FILE_FS_CONTROL_INFORMATION) sein.

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

Anforderungen

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

Weitere Informationen

FltQueryVolumeInformation

FltSetVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

IRP_MJ_SET_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

ZwSetVolumeInformationFile