FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)
为目标卷上的更新序列号(USN)更改日记流启用范围跟踪功能,或修改已启用的范围跟踪参数。
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to volume
FSCTL_USN_TRACK_MODIFIED_RANGES, // dwIoControlCode
(LPDWORD) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
(LPDWORD) lpOutBuffer, // lpOutbuffer
(DWORD) nOutBufferSize, // size of output buffer
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);
言论
有关此操作中重叠 I/O 的影响,请参阅 DeviceIoControl 主题的“备注”部分。
可以使用 FSCTL_USN_TRACK_MODIFIED_RANGES 为卷首次启用范围跟踪。 启用范围跟踪后,状态和参数将保留该卷,下次重新启动时,将从持久化参数中初始化范围跟踪。
还可以使用 FSCTL_USN_TRACK_MODIFIED_RANGES 修改现有的更改日记流范围跟踪参数。 如果区域跟踪已存在,FSCTL_USN_TRACK_MODIFIED_RANGES 将其设置为 USN_TRACK_MODIFIED_RANGES 结构中提供的参数。 块大小或文件大小阈值只能从以前的值中降低。 启用后,除非删除日记,否则无法禁用范围跟踪功能。
若要检索卷的句柄,请调用 CreateFile,lpFileName 参数设置为以下格式的字符串:
\\.\X:
在前面的字符串中,X 是标识卷所在的驱动器的字母。 卷必须是 NTFS 3.0 或更高版本。 若要获取卷的 NTFS 版本,请使用管理员访问权限打开命令提示符并执行以下命令:
fsinfo ntfsinfoX:
其中,X 是卷的驱动器号。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8.1 [仅限桌面应用] |
支持的最低服务器 | Windows Server 2012 R2 [仅限桌面应用] |
标头 | winioctl.h (包括 Windows.h) |