FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

项目
03/09/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 主题的“备注”部分。

有两个返回 USN 记录的 DeviceIoControl 控制代码， 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)	否
群集共享卷文件系统 (CSV)	查看注释

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

示例

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

要求

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