struttura USN_JOURNAL_DATA_V2 (winioctl.h)

Articolo
03/08/2023

Rappresenta un giornale di registrazione delle modifiche del numero di sequenza di aggiornamento (USN), i relativi record e la relativa capacità. Questa struttura è il buffer di output per il codice di controllo FSCTL_QUERY_USN_JOURNAL .

Sintassi

typedef struct {
  DWORDLONG UsnJournalID;
  USN       FirstUsn;
  USN       NextUsn;
  USN       LowestValidUsn;
  USN       MaxUsn;
  DWORDLONG MaximumSize;
  DWORDLONG AllocationDelta;
  WORD      MinSupportedMajorVersion;
  WORD      MaxSupportedMajorVersion;
  DWORD     Flags;
  DWORDLONG RangeTrackChunkSize;
  LONGLONG  RangeTrackFileSizeThreshold;
} USN_JOURNAL_DATA_V2, *PUSN_JOURNAL_DATA_V2;

Members

UsnJournalID

Identificatore del journal corrente. A un giornale di registrazione viene assegnato un nuovo identificatore durante la creazione e può essere stampato con un nuovo identificatore nel corso della sua esistenza. Il file system NTFS usa questo identificatore per un controllo di integrità.

FirstUsn

Numero del primo record che può essere letto dal journal.

NextUsn

Numero di record successivi da scrivere nel giornale di registrazione.

LowestValidUsn

Primo record scritto nel journal per questa istanza del journal. L'enumerazione dei file o delle directory in un volume può restituire un VALORE USN inferiore a questo valore( in altre parole, un valore membro FirstUsn minore del valore del membro LowestValidUsn ). In caso affermativo, il giornale di registrazione è stato stampato con un nuovo identificatore dopo la scrittura dell'ultimo USN. In questo caso , LowestValidUsn può indicare una discontinuità nel journal, in cui le modifiche apportate ad alcuni o a tutti i file o a tutte le directory nel volume potrebbero essersi verificate che non sono registrate nel journal delle modifiche.

MaxUsn

Numero USN più grande supportato dal journal delle modifiche. Un amministratore deve eliminare il journal delle modifiche perché il valore di NextUsn si avvicina a questo valore.

MaximumSize

Dimensione massima di destinazione per il journal delle modifiche, in byte. Il journal delle modifiche può aumentare di dimensioni superiori a questo valore, ma viene quindi troncato al checkpoint del file system NTFS successivo a un valore minore di questo valore.

AllocationDelta

Numero di byte di memoria del disco aggiunto alla fine e rimosso dall'inizio del journal delle modifiche ogni volta che la memoria viene allocata o deallocata. In altre parole, l'allocazione e la deallocazione vengono eseguite in unità di questa dimensione. Un numero intero multiplo di dimensioni del cluster è un valore ragionevole per questo membro.

MinSupportedMajorVersion

Versione minima del journal delle modifiche USN supportata dal file system.

MaxSupportedMajorVersion

Versione massima del journal delle modifiche USN supportata dal file system.

Flags

Indica se il rilevamento dell'intervallo è attivato o meno. Di seguito sono riportati i valori possibili per il membro Flags .

Valore	Significato
0x00000000	Il rilevamento dell'intervallo non è attivato per il volume.
FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE 0x00000001	Il rilevamento dell'intervallo è attivato per il volume.

RangeTrackChunkSize

Granularità degli intervalli rilevati. Valido solo quando si imposta anche il membro Flags su FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE.

RangeTrackFileSizeThreshold

Soglia delle dimensioni del file per avviare l'intervallo di rilevamento per i file con dimensioni uguali o maggiori. Valido solo quando si imposta anche il membro Flags su FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

FSCTL_QUERY_USN_JOURNAL

USN_JOURNAL_DATA_V0

USN_JOURNAL_DATA_V1

Strutture di gestione dei volumi

Share via