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;
Member
VolumeFlags
Die Einstellungen für den persistenten Zustand für ein Dateisystemvolume. Dieser Wert ist eine bitweise OR-Kombination der folgenden.
| Wert | Bedeutung |
|---|---|
| PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001 | Eine 0 für dieses Bit gibt an, dass die Erstellung von 8.3-Kurznamen aktiviert ist, und eine 1 gibt an, dass die Erstellung kurzer Namen deaktiviert ist. 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 Flag festgelegt ist, gibt dieses Flag an, dass die Volumebereinigung für das Volume deaktiviert ist. Gültig ab Windows 8. |
| PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY 0x00000004 | Global ist keine Suchstrafe für ein mehrstufiges Volume aktiviert. Gültig ab Windows 8.1. |
| PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008 | Lokal ist keine Suchstrafe für ein mehrstufiges Volume aktiviert. Gültig ab Windows 8.1. |
| PERSISTENT_VOLUME_STATE_NO_HEAT_GATHERING 0x00000010 | Wenn festgelegt, ist die Wärmeerfassung für das mehrstufige Volume 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 sichert. Dieses Flag 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, bei denen kein Administrator dem Volume auf einem bestimmten Computer vertrauen muss. Gültig ab Windows 11, Version 22H2 September Update. |
| PERSISTENT_VOLUME_STATE_TRUSTED_VOLUME 0x00004000 | Gibt an, dass ein Administrator auf einem bestimmten Computer diesem Volume vertraut hat und bereit ist, Optimierungen zu aktivieren, z. B. dass keine Antivirenfilter an das Volume angefügt werden. Diese Informationen werden in der Registrierung auf einem bestimmten Computer beibehalten. Dies kann vom Dateisystem und anderen Systemkomponenten verwendet werden, um Optimierungen zu ermöglichen, bei denen ein Administrator dem Volume auf einem bestimmten Computer vertrauen 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 VolumeFlags beschrieben werden.
Version
Die Versionsnummer dieser Struktur. Auf 1 festlegen.
Reserved
Reserviert. Legen Sie auf 0 fest;
Hinweise
Die FILE_FS_PERSISTENT_VOLUME_INFORMATION-Struktur wird mit den FSCTL_SET_PERSISTENT_VOLUME_STATE- und FSCTL_QUERY_PERSISTENT_VOLUME_STATE-Steuerungscodes verwendet.
Um die Statusflags abzufragen, ist FlagMask auf eine Kombination von Flags festgelegt, auf die überprüft werden soll. Wenn z. B. nur die Suchstrafflags von Interesse sind, flagMask = PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY | PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY. Wenn nur kurznameunterstützung abgefragt wird, legen Sie außerdem FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED fest.
Beim Festlegen oder Löschen der Statusflags für persistente Volumes mithilfe von FSCTL_SET_PERSISTENT_VOLUME_STATE wird FlagMask auf alle Flags in VolumeFlags festgelegt, die für das Volume betroffen sind. VolumeFlags enthält die tatsächlichen flags für den persistenten Zustand, die für das Volume festgelegt werden sollen. Im folgenden Beispiel wird gezeigt, wie die Member von FILE_FS_PERSISTENT_VOLUME_INFORMATION festgelegt werden , um die Erstellung von Kurznamen für ein Volume zu aktivieren.
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 Versionselement muss sowohl für eine Abfrage als auch für eine Setanforderung auf die aktuelle Version 1 festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Kopfzeile | ntifs.h (include Ntifs.h) |