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) |