QueryChangesVirtualDisk 函数 (virtdisk.h)
检索有关虚拟硬盘 (VHD) 指定区域的更改的信息，这些更改由可复原更改跟踪 (RCT) 进行跟踪。
语法
DWORD QueryChangesVirtualDisk(
[in] HANDLE VirtualDiskHandle,
[in] PCWSTR ChangeTrackingId,
[in] ULONG64 ByteOffset,
[in] ULONG64 ByteLength,
[in] QUERY_CHANGES_VIRTUAL_DISK_FLAG Flags,
[out] PQUERY_CHANGES_VIRTUAL_DISK_RANGE Ranges,
[in, out] PULONG RangeCount,
[out] PULONG64 ProcessedLength
);
参数
[in] VirtualDiskHandle
打开的 VHD 的句柄，该句柄必须已使用 OpenVirtualDisk 函数的 VirtualDiskAccessMask 参数中设置的 VIRTUAL_DISK_ACCESS_GET_INFO 标志打开。 有关如何打开 VHD 的信息，请参阅 OpenVirtualDisk 函数。
[in] ChangeTrackingId
指向字符串的指针，该字符串指定更改跟踪标识符，该更改标识要用作比较基础的虚拟磁盘的状态，以确定 VHD 的指定区域是否已更改。
[in] ByteOffset
一个无符号长整数，指定从 VHD 开始到要检查更改的 VHD 区域开头的距离（以字节为单位）。
[in] ByteLength
一个无符号长整数，指定要检查更改的 VHD 区域的长度（以字节为单位）。
[in] Flags
保留。 设置为 QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE。
[out] Ranges
一个QUERY_CHANGES_VIRTUAL_DISK_RANGE结构数组，指示自 ChangeTrackingId 参数指定的更改跟踪标识符密封以来，ByteOffset 和 ByteLength 参数指定的区域中已更改的虚拟磁盘区域。
[in, out] RangeCount
无符号长整数的地址。 输入时， 值指示 Ranges 参数指向的数组可以容纳的QUERY_CHANGES_VIRTUAL_DISK_RANGE结构数。 输出时， 值包含方法放置在数组中的 QUERY_CHANGES_VIRTUAL_DISK_RANGE 结构的数目。
[out] ProcessedLength
指向无符号长整数的指针，指示方法处理的字节总数，指示 BytesLength 参数指定在 Ranges 参数指定的数组的可用空间中捕获更改的区域量。
返回值
请求的状态。
如果函数成功，则返回值 ERROR_SUCCESS 并且 Ranges 参数包含请求的信息。
如果函数失败，则返回值为错误代码。 有关详细信息，请参阅 系统错误代码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2016 |
| 目标平台 | Windows |
| 标头 | virtdisk.h |
| Library | VirtDisk.lib |
| DLL | VirtDisk.dll |