FILE_FS_CONTROL_INFORMATION-Struktur (ntifs.h)
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 an freiem Speicherplatz in Bytes, der für den Content-Indexing-Daemon erforderlich ist, um mit der Dokumentfilterung zu beginnen.
FreeSpaceThreshold
Mindestmenge an freiem Speicherplatz in Byte, 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 Ereignisprotokoll der Microsoft Windows-Anwendung geschrieben. Das Filtern und Zusammenführen wird angehalten, bis speicherplatzfrei ist.
FreeSpaceStopFiltering
Mindestmenge an freiem Speicherplatz 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
Standardmäßiger Schwellenwert 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 von benutzerbezogenen Kontingentereignissen auf dem Volume steuern. Mit der Protokollierung wird ein Eintrag im Ereignisprotokoll der Windows-Anwendung erstellt. Kompatible Kombination einer oder mehrerer der folgenden Optionen:
| Dateisystemsteuerungsflag | 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ägerkontingent überschreitet. |
| FILE_VC_LOG_QUOTA_THRESHOLD | Wenn diese Einstellung festgelegt ist, wird ein Ereignisprotokolleintrag erstellt, wenn der Benutzer seinen zugewiesenen Schwellenwert für Kontingentwarnungen überschreitet. |
| FILE_VC_LOG_VOLUME_LIMIT | Wenn dieser Wert festgelegt ist, wird ein Ereignisprotokolleintrag erstellt, wenn das Limit für freien Speicherplatz 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 | Wenn 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 Flag-Masken 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 | Nicht mehr enthaltene 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 Sie einen vom Aufrufer zugeordneten, FILE_FS_CONTROL_INFORMATION strukturierten Puffer als Wert von FileInformation.
- Erstellen Sie eine IRP mit hauptfunktionscode IRP_MJ_QUERY_VOLUME_INFORMATION.
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 vom Aufrufer zugeordneten, FILE_FS_CONTROL_INFORMATION strukturierten Puffer als Wert von FileInformation.
- Erstellen Sie ein IRP mit hauptfunktionscode IRP_MJ_SET_VOLUME_INFORMATION.
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.
Requirements (Anforderungen)
| Kopfzeile | ntifs.h (include Ntifs.h, Fltkernel.h) |