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

FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Статья

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

Чтобы выполнить эту операцию, вызовите функцию 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 Нет
Отработка отказа SMB 3.0 (TFO) Нет
SMB 3.0 с масштабируемыми общими папками (SO) Нет
Файловая система общего тома кластера (CSVFS) Да

Требования

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

См. также

CreateFile

DeviceIoControl

USN_RECORD

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