FILE_FS_PERSISTENT_VOLUME_INFORMATION Struktur (ntifs.h)
Die FILE_FS_PERSISTENT_VOLUME_INFORMATION Struktur wird verwendet, um persistente Einstellungen für ein Dateisystemvolume zu steuern. Persistente Einstellungen bleiben auf einem Dateisystemvolume zwischen Neustarts des Computers erhalten.
Syntax
typedef struct _FILE_FS_PERSISTENT_VOLUME_INFORMATION {
ULONG VolumeFlags;
ULONG FlagMask;
ULONG Version;
ULONG Reserved;
} FILE_FS_PERSISTENT_VOLUME_INFORMATION, *PFILE_FS_PERSISTENT_VOLUME_INFORMATION;
Angehörige
VolumeFlags
Die Einstellungen für den beständigen Zustand für ein Dateisystemvolume. Dieser Wert ist eine bitweise OR-Kombination aus dem folgenden.
| Wert | Bedeutung |
|---|---|
| PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001 | A 0 for this bit indicates that the creation of 8.3 short names is enabled, and a 1 indicates that short name creation is disabled. 8.3 Kurze Dateinamen haben höchstens acht Zeichen, gefolgt von einem Punkt "." und einer Dateinamenerweiterung von höchstens drei Zeichen. |
| PERSISTENT_VOLUME_STATE_VOLUME_SCRUB_DISABLED 0x00000002 | Wenn dieses Kennzeichen festgelegt ist, gibt dieses Kennzeichen an, dass das Volume scrub für das Volume deaktiviert ist. Gültig ab Windows 8. |
| PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY 0x00000004 | Für ein gestaffeltes Volume ist keine Suchstrafe aktiviert. Gültig ab Windows 8.1. |
| PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008 | Für ein gestaffeltes Volume ist keine Strafstrafe für lokale Zwecke aktiviert. Gültig ab Windows 8.1. |
| PERSISTENT_VOLUME_STATE_NO_HEAT_GATHERING 0x00000010 | Bei Festlegung ist die Wärmeerfassung für das gestaffelte Volumen nicht aktiviert. Gültig ab Windows 8.1. |
| PERSISTENT_VOLUME_STATE_CONTAINS_BACKING_WIM 0x00000020 | Gibt an, dass dieses Volume das Systemvolume mit Dateien aus einer WIM-Datei (Windows Image Format) unterstützt. Gültig ab Windows 8.1 Update. |
| PERSISTENT_VOLUME_STATE_BACKED_BY_WIM 0x00000040 | Gibt an, dass dieses Volume von einem anderen Volume abhängig ist, um systemkritische Startdateien bereitzustellen. Das andere Volume enthält eine WIM-Datei, die die Dateien auf diesem Volume zurückgibt. Dieses Kennzeichen ist schreibgeschützt. Gültig ab Windows 8.1 Update. |
| PERSISTENT_VOLUME_STATE_DEV_VOLUME 0x00002000 | Gibt an, dass dieses Volume als Entwicklervolume formatiert ist. Dies kann vom Dateisystem und anderen Systemkomponenten verwendet werden, um Optimierungen zu ermöglichen, die keinen Administrator benötigen, um dem Volume auf einem bestimmten Computer zu vertrauen. Gültig ab Windows 11, Version 22H2 September Update. |
| PERSISTENT_VOLUME_STATE_TRUSTED_VOLUME 0x00004000 | Gibt an, dass ein Administrator auf einem bestimmten Computer dieses Volume als vertrauenswürdig eingestuft hat und bereit ist, Optimierungen wie das Anfügen von Antivirenfiltern an das Volume zu ermöglichen. Diese Informationen werden in der Registrierung auf einem bestimmten Computer gespeichert. Dies kann vom Dateisystem und anderen Systemkomponenten verwendet werden, um Optimierungen zu ermöglichen, für die ein Administrator das Volume auf einem bestimmten Computer als vertrauenswürdig festlegen muss. Gültig ab Windows 11, Version 22H2 September Update. |
FlagMask
Ein Maskenwert für die gültigen Flags, die in VolumeFlags-angezeigt werden können. Dies ist eine bitweise OR-Kombination der gewünschten Flags, die für VolumeFlagsbeschrieben werden.
Version
Die Versionsnummer dieser Struktur. Auf 1 festgelegt.
Reserved
Reserviert. Auf 0 festgelegt;
Bemerkungen
Die FILE_FS_PERSISTENT_VOLUME_INFORMATION-Struktur wird mit den FSCTL_SET_PERSISTENT_VOLUME_STATE- und FSCTL_QUERY_PERSISTENT_VOLUME_STATE Steuercodes verwendet.
Um die Statuskennzeichnungen abzufragen, wird FlagMask- auf eine Kombination von Kennzeichen festgelegt, auf die überprüft werden soll. Wenn beispielsweise die einzigen Zielstrafenflaggen von Interesse sind, FlagMask = PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY | PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY. Wenn nur die Unterstützung für kurze Namen abgefragt wird, legen Sie außerdem FlagMask- = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED fest.
Beim Festlegen oder Löschen der Flags für den beständigen Volumestatus mit FSCTL_SET_PERSISTENT_VOLUME_STATEwird FlagMask- auf alle Flags in VolumeFlags- festgelegt, die für das Volume betroffen sind. VolumeFlags- enthält die tatsächlichen flags für beständigen Zustand, die für das Volume festgelegt werden sollen. Das folgende Beispiel zeigt, wie die Member von FILE_FS_PERSISTENT_VOLUME_INFORMATION so festgelegt werden, dass die Erstellung von Kurznamen für ein Volume aktiviert wird.
IO_STATUS_BLOCK IoStatus;
FILE_FS_PERSISTENT_VOLUME_INFORMATION PersistVolInfo;
NTSTATUS status;
PersistVolInfo.VolumeFlags = 0; // enable shortname creation on this volume
PersistVolInfo.FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED;
PersistVolInfo.Version = 1;
PersistVolInfo.Reserved = 0;
// issue the request to the file system to set the enable state
//
status = ZwFsControlFile( VolumeHandle,
NULL,
NULL,
NULL,
&IoStatus,
FSCTL_SET_PERSISTENT_VOLUME_STATE,
&PersistVolInfo,
sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION),
NULL,
0 );
Das Version Member muss für eine Abfrage und eine Setanforderung auf die aktuelle Version von 1 festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 |
| Header- | ntifs.h (einschließlich Ntifs.h) |