struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION (ntifs.h)

  • Articolo

La struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION viene usata per controllare le impostazioni persistenti per un volume del file system. Le impostazioni persistenti vengono mantenute 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 della seguente.

Valore Significato
PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001 Un valore 0 per questo bit indica che la creazione di nomi brevi 8.3 è 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 di 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 La penalità globale senza ricerca è abilitata per un volume a livelli. Valido a partire da Windows 8.1.
PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008 La penalità locale senza 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 di windows Image Format (WIM). 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 è formattato come volume per sviluppatori. Può essere usato 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, aggiornamento di settembre 22H2.
PERSISTENT_VOLUME_STATE_TRUSTED_VOLUME 0x00004000 Indica che un amministratore in un determinato computer ha considerato attendibile questo volume ed è disposto ad abilitare ottimizzazioni come non avere filtri antivirus collegati al volume. Queste informazioni vengono rese persistenti nel Registro di sistema in un determinato computer. Può essere usato 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, aggiornamento di settembre 22H2.

FlagMask

Valore mask 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. Impostato su 0;

Commenti

La struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION viene utilizzata con i codici di controllo FSCTL_SET_PERSISTENT_VOLUME_STATE e FSCTL_QUERY_PERSISTENT_VOLUME_STATE .

Per eseguire una 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 eseguita una query solo per il supporto dei nomi brevi, impostare FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED.

Quando si impostano o cancellano i flag di stato del volume permanente, 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 Version deve essere impostato sulla versione corrente di 1 sia per una query che per una richiesta set.

Requisiti

Requisito Valore
Client minimo supportato Windows 7
Intestazione ntifs.h (include Ntifs.h)

Vedi anche

FSCTL_QUERY_PERSISTENT_VOLUME_STATE

FSCTL_SET_PERSISTENT_VOLUME_STATE