FSCTL_READ_USN_JOURNAL IOCTL （winioctl.h）

项目
06/27/2024

检索两个指定 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

言论

有关此操作中重叠 I/O 的影响，请参阅 DeviceIoControl 主题的“备注”部分。

有两个 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 透明故障转移（TFO）	不
具有横向扩展文件共享的 SMB 3.0 （SO）	不
群集共享卷文件系统（CsvFS）	请参阅批注

应用程序可能会在 Csv 暂停/恢复时遇到误报。

例子

有关示例，请参阅步行更改日记记录缓冲区。

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
标头	winioctl.h （包括 Windows.h）