FILE_FS_PERSISTENT_VOLUME_INFORMATION struttura (ntifs.h)
La struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION viene usata per controllare le impostazioni persistenti per un volume del file system. Le impostazioni persistenti persistono in un volume del file system tra i riavvii del computer.
Sintassi
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;
Members
VolumeFlags
Impostazioni dello stato persistente per un volume del file system. Questo valore è una combinazione OR bit per bit del seguente.
| Valore | Significato |
|---|---|
| PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001 | Un valore 0 per questo bit indica che la creazione di 8.3 nomi brevi è abilitata e 1 indica che la creazione di nomi brevi è disabilitata. 8.3 i nomi di file brevi hanno al massimo otto caratteri, seguiti da un punto "." e da un'estensione del nome file di al massimo tre caratteri. |
| PERSISTENT_VOLUME_STATE_VOLUME_SCRUB_DISABLED 0x00000002 | Se impostato, questo flag indica che lo scrub del volume è disabilitato per il volume. Valido a partire da Windows 8. |
| PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY 0x00000004 | Nessuna penalità globale di ricerca è abilitata per un volume a livelli. Valido a partire da Windows 8.1. |
| PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008 | Nessuna penalità locale di ricerca è abilitata per un volume a livelli. Valido a partire da Windows 8.1. |
| PERSISTENT_VOLUME_STATE_NO_HEAT_GATHERING 0x00000010 | Se impostato, la raccolta termica non è abilitata per il volume a livelli. Valido a partire da Windows 8.1. |
| PERSISTENT_VOLUME_STATE_CONTAINS_BACKING_WIM 0x00000020 | Indica che questo volume esegue il backup del volume di sistema con file da un file WIM (Windows Image Format). Valido a partire da Windows 8.1 Update. |
| PERSISTENT_VOLUME_STATE_BACKED_BY_WIM 0x00000040 | Indica che questo volume dipende da un altro volume per fornire file di avvio critici del sistema. L'altro volume contiene un file WIM che esegue il backup dei file in questo volume. Questo flag è di sola lettura. Valido a partire da Windows 8.1 Update. |
| PERSISTENT_VOLUME_STATE_DEV_VOLUME 0x00002000 | Indica che questo volume viene formattato come volume per sviluppatori. Questa operazione può essere usata dal file system e da altri componenti di sistema per abilitare le ottimizzazioni che non richiedono a un amministratore di considerare attendibile il volume in un determinato computer. Valido a partire da Windows 11, versione 22H2 Settembre Update. |
| PERSISTENT_VOLUME_STATE_TRUSTED_VOLUME 0x00004000 | Indica che un amministratore in un determinato computer ha considerato attendibile questo volume ed è disposto a abilitare ottimizzazioni come non avere filtri anti-virus collegati al volume. Queste informazioni vengono mantenute nel Registro di sistema in un determinato computer. Questa operazione può essere usata dal file system e da altri componenti di sistema per abilitare le ottimizzazioni che richiedono a un amministratore di considerare attendibile il volume in un determinato computer. Valido a partire da Windows 11, versione 22H2 Settembre Update. |
FlagMask
Valore maschera per i flag validi che possono essere visualizzati in VolumeFlags. Si tratta di una combinazione OR bit per bit dei flag desiderati descritti per VolumeFlags.
Version
Numero di versione di questa struttura. impostare su 1.
Reserved
Riservato. Impostare su 0;
Commenti
La struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION viene usata con i codici di controllo FSCTL_SET_PERSISTENT_VOLUME_STATE e FSCTL_QUERY_PERSISTENT_VOLUME_STATE .
Per eseguire query sui flag di stato, FlagMask è impostato su una combinazione di flag da verificare. Ad esempio, se l'unico flag di penalità di ricerca è di interesse, FlagMask = PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY | PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY. Inoltre, se viene eseguito solo un supporto di nome breve, impostare FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED.
Quando si impostano o cancellano i flag di stato del volume persistente, usando FSCTL_SET_PERSISTENT_VOLUME_STATE, FlagMask è impostato su tutti i flag in VolumeFlags interessati per il volume. VolumeFlags contiene i flag di stato persistenti effettivi da impostare per il volume. Nell'esempio seguente viene illustrato come impostare i membri di FILE_FS_PERSISTENT_VOLUME_INFORMATION per abilitare la creazione di nomi brevi per un volume.
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 );
Il membro Versione deve essere impostato sulla versione corrente di 1 per una query e una richiesta impostata.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 |
| Intestazione | ntifs.h (include Ntifs.h) |