QueryChangesVirtualDisk-Funktion (virtdisk.h)

Artikel
08/27/2023

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

Weitere Informationen

Informationen zu VHD

QUERY_CHANGES_VIRTUAL_DISK_RANGE

VHD-Referenz

Share via