QueryChangesVirtualDisk 函式 (virtdisk.h)
擷取由復原變更追蹤 (RCT) 所追蹤之虛擬硬碟 (VHD) 之指定區域變更的相關信息。
語法
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 的句柄，必須使用 VirtualDiskAccessMask 參數中設定的 VIRTUAL_DISK_ACCESS_GET_INFO 旗標開啟，才能開啟該 VHD。 如需如何開啟 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 結構的陣列，指出 ByteOffset 和 ByteLength 參數指定自 ChangeTrackingId 參數指定的變更追蹤標識符之後，已變更的虛擬磁碟區域。
[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 |
| 程式庫 | VirtDisk.lib |
| Dll | VirtDisk.dll |