Поделиться через


структура USN_JOURNAL_DATA_V2 (winioctl.h)

Представляет журнал изменений с порядковым номером обновления (USN), его записями и емкостью. Эта структура представляет собой выходной буфер для кода элемента управления FSCTL_QUERY_USN_JOURNAL.

Синтаксис

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;

Члены

UsnJournalID

Текущий идентификатор журнала. Журнал назначается новому идентификатору при создании и может быть помечен новым идентификатором в ходе его существования. Файловая система NTFS использует этот идентификатор для проверки целостности.

FirstUsn

Число первых записей, которые можно прочитать из журнала.

NextUsn

Число следующих записей, записываемых в журнал.

LowestValidUsn

Первая запись, записанная в журнал для этого экземпляра журнала. Перечисление файлов или каталогов тома может возвращать значение USN ниже этого значения (иными словами, значение члена FirstUsn меньше, чем значение члена LowerValidUsn). Если это так, журнал был помечен новым идентификатором с момента написания последнего номера USN. В этом случае lowestValidUsn могут указывать на разрыв в журнале, в котором изменения некоторых или всех файлов или каталогов тома могут произойть, которые не записываются в журнале изменений.

MaxUsn

Самый большой USN, поддерживаемый журналом изменений. Администратор должен удалить журнал изменений в качестве значения NextUsn подходит к этому значению.

MaximumSize

Целевой максимальный размер журнала изменений в байтах. Журнал изменений может увеличиться больше этого значения, но затем усечен на следующей контрольной точке файловой системы NTFS до меньше этого значения.

AllocationDelta

Количество байтов памяти диска, добавленных в конец и удаленных из начала журнала изменений каждый раз, когда память выделяется или освобождается. Другими словами, распределение и размещение сделки происходят в единицах этого размера. Целое число нескольких размеров кластера является разумным значением для этого элемента.

MinSupportedMajorVersion

Минимальная версия журнала изменений USN, которую поддерживает файловая система.

MaxSupportedMajorVersion

Максимальная версия журнала изменений USN, которую поддерживает файловая система.

Flags

Включена ли функция отслеживания диапазона. Ниже приведены возможные значения для элемента Flags.

Ценность Значение
0x00000000
Отслеживание диапазона не включается для тома.
FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE
0x00000001
Отслеживание диапазона включается для тома.

RangeTrackChunkSize

Степень детализации отслеживаемых диапазонов. Допустимо только в том случае, если для элемента флагов задано значение FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE.

RangeTrackFileSizeThreshold

Пороговое значение размера файла для запуска диапазона отслеживания файлов с равным или большим размером. Допустимо только в том случае, если для элемента флагов задано значение FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8.1 [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2012 R2 [только классические приложения]
заголовка winioctl.h (включая Windows.h)

См. также

FSCTL_QUERY_USN_JOURNAL

USN_JOURNAL_DATA_V0

USN_JOURNAL_DATA_V1

структуры управления томами