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

FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Статья

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

Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_USN_DATA, // 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

Комментарии

Если вызов выполнен успешно, члены возвращаемой структуры USN_RECORD_V2 или USN_RECORD_V3 допустимы, за исключением следующих элементов: TimeStamp, Reason и SourceInfo. Элемент USN представляет последний номер USN, записанный в журнал для этого файла или каталога.

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

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

\.\X:

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

FSUtil.exe FSInfo NTFSInfo X:

где X — буква диска тома.

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

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

Требования

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

См. также раздел

CreateFile

DeviceIoControl

USN_RECORD

Управляющие коды для управления томами