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 结构中提供的参数。 块大小或文件大小阈值只能从以前的值中降低。 启用后,除非删除日记,否则无法禁用范围跟踪功能。

若要检索卷的句柄,请调用 CreateFilelpFileName 参数设置为以下格式的字符串:

\\.\X:

在前面的字符串中,X 是标识卷所在的驱动器的字母。 卷必须是 NTFS 3.0 或更高版本。 若要获取卷的 NTFS 版本,请使用管理员访问权限打开命令提示符并执行以下命令:

fsinfo ntfsinfoX

其中,X 是卷的驱动器号。

要求

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

另请参阅