FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

Статья
08/27/2023

Извлекает набор записей журнала изменений последовательного номера обновления (USN) между двумя указанными значениями USN.

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode (LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer (LPVOID) lpOutBuffer, // output buffer (DWORD) nOutBufferSize, // size of output buffer (LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

C++

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to volume
                 (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode
                 (LPVOID)       lpInBuffer,      // input buffer
                 (DWORD)        nInBufferSize,   // size of input buffer
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Существует два кода элемента управления DeviceIoControl , которые возвращают записи USN: FSCTL_READ_USN_JOURNAL и FSCTL_ENUM_USN_DATA. Используйте последний, если требуется перечисление (перечисление) записей USN между двумя usn. Используйте первый, если вы хотите выбрать по usn.

Дополнительные сведения см. в статье Создание, изменение и удаление Журнал изменений.

Чтобы получить дескриптор тома, вызовите CreateFile с параметром lpFileName , для которого задана строка в следующей форме:

\.\X:

В предыдущей строке X — это буква, обозначающая диск, на котором отображается том. Том должен быть NTFS.

В Windows 8 и Windows Server 2012 этот код поддерживается следующими технологиями.

Технология	Поддерживается
Протокол SMB 3.0	Нет
SMB 3.0 Transparent Failover (TFO)	Нет
SMB 3.0 с масштабируемыми общими папками (SO)	Нет
Файловая система общего тома кластера (CSVFS)	См. комментарий

Приложение может столкнуться с ложными срабатываниями при приостановке или возобновлении работы CSVF.

Примеры

Пример см. в разделе Обход буфера изменений Журнал записей.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	winioctl.h (включая Windows.h)