QueryChangesVirtualDisk-Funktion (virtdisk.h)
Ruft Informationen zu Änderungen an den angegebenen Bereichen einer virtuellen Festplatte (VHD) ab, die durch die resiliente Änderungsnachverfolgung (Resilient Change Tracking, RCT) nachverfolgt werden.
Syntax
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
);
Parameter
[in] VirtualDiskHandle
Ein Handle für die geöffnete VHD, die mithilfe des VIRTUAL_DISK_ACCESS_GET_INFO-Flags geöffnet worden sein muss, das im VirtualDiskAccessMask-Parameter auf die OpenVirtualDisk-Funktion festgelegt ist . Informationen zum Öffnen einer VHD finden Sie in der OpenVirtualDisk-Funktion .
[in] ChangeTrackingId
Ein Zeiger auf eine Zeichenfolge, die den Änderungsnachverfolgungsbezeichner für die Änderung angibt, der den Zustand des virtuellen Datenträgers angibt, den Sie als Vergleichsgrundlage verwenden möchten, um zu bestimmen, ob sich der angegebene Bereich der VHD geändert hat.
[in] ByteOffset
Eine ganze Zahl ohne Vorzeichen, die den Abstand zwischen dem Anfang der VHD und dem Anfang des Bereichs der VHD angibt, den Sie auf Änderungen in Bytes überprüfen möchten.
[in] ByteLength
Eine ganze Zahl ohne Vorzeichen, die die Länge des Bereichs der VHD angibt, den Sie auf Änderungen in Bytes überprüfen möchten.
[in] Flags
Reserviert. Legen Sie auf QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE fest.
[out] Ranges
Ein Array von QUERY_CHANGES_VIRTUAL_DISK_RANGE Strukturen, das die Bereiche des virtuellen Datenträgers innerhalb des Bereichs angibt, den die Parameter ByteOffset und ByteLength angeben, die sich geändert haben, da der vom ChangeTrackingId-Parameter angegebene Änderungsnachverfolgungsbezeichner versiegelt wurde.
[in, out] RangeCount
Eine Adresse einer ganzzahligen Zahl ohne Vorzeichen. Bei der Eingabe gibt der Wert die Anzahl QUERY_CHANGES_VIRTUAL_DISK_RANGE Strukturen an, die das Array enthalten kann, auf das der Ranges-Parameter verweist. Bei der Ausgabe enthält der Wert die Anzahl QUERY_CHANGES_VIRTUAL_DISK_RANGE Strukturen, die die Methode im Array platziert hat.
[out] ProcessedLength
Ein Zeiger auf eine lange ganzzahlige Zahl ohne Vorzeichen, die die Gesamtanzahl der von der Methode verarbeiteten Bytes angibt. Dieser gibt an, wie viel des Bereichs der BytesLength-Parameter angibt, dass Änderungen im verfügbaren Bereich des Arrays erfasst wurden, das der Parameter Ranges angibt.
Rückgabewert
Der Status der Anforderung.
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS , und der Parameter Ranges enthält die angeforderten Informationen.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode. Weitere Informationen finden Sie unter Systemfehlercodes.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| Kopfzeile | virtdisk.h |
| Bibliothek | VirtDisk.lib |
| DLL | VirtDisk.dll |