Fungsi QueryChangesVirtualDisk (virtdisk.h)

Mengambil informasi tentang perubahan pada area tertentu dari hard disk virtual (VHD) yang dilacak oleh pelacakan perubahan tangguh (RCT).

Sintaks

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

Handel ke VHD terbuka, yang harus dibuka menggunakan bendera VIRTUAL_DISK_ACCESS_GET_INFO yang diatur dalam parameter VirtualDiskAccessMask ke fungsi OpenVirtualDisk . Untuk informasi tentang cara membuka VHD, lihat fungsi OpenVirtualDisk .

[in] ChangeTrackingId

Penunjuk ke string yang menentukan pengidentifikasi pelacakan perubahan untuk perubahan yang mengidentifikasi status disk virtual yang ingin Anda gunakan sebagai dasar perbandingan untuk menentukan apakah area VHD yang ditentukan telah berubah.

[in] ByteOffset

Bilangan bulat panjang yang tidak ditandatangani yang menentukan jarak dari awal VHD ke awal area VHD yang ingin Anda periksa perubahannya, dalam byte.

[in] ByteLength

Bilangan bulat panjang yang tidak ditandatangani yang menentukan panjang area VHD yang ingin Anda periksa perubahannya, dalam byte.

[in] Flags

Dicadangkan. Atur ke QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.

[out] Ranges

Array struktur QUERY_CHANGES_VIRTUAL_DISK_RANGE yang menunjukkan area disk virtual dalam area yang ditentukan oleh parameter ByteOffset dan ByteLength yang telah berubah sejak pengidentifikasi pelacakan perubahan yang ditentukan parameter ChangeTrackingId disegel.

[in, out] RangeCount

Alamat bilangan bulat panjang yang tidak ditandatangani. Pada input, nilai menunjukkan jumlah struktur QUERY_CHANGES_VIRTUAL_DISK_RANGE yang dapat ditahan oleh parameter Rentang . Pada output, nilai berisi jumlah struktur QUERY_CHANGES_VIRTUAL_DISK_RANGE yang ditempatkan metode dalam array.

[out] ProcessedLength

Penunjuk ke bilangan bulat panjang yang tidak ditandatangani yang menunjukkan jumlah total byte yang diproses metode, yang menunjukkan berapa banyak area yang ditentukan parameter BytesLength bahwa perubahan diambil di ruang array yang tersedia yang ditentukan parameter Rentang .

Mengembalikan nilai

Status permintaan.

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS dan parameter Rentang berisi informasi yang diminta.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan. Untuk informasi selengkapnya, lihat Kode Kesalahan Sistem.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Server Windows 2016
Target Platform	Windows
Header	virtdisk.h
Pustaka	VirtDisk.lib
DLL	VirtDisk.dll

Lihat juga

Tentang VHD

QUERY_CHANGES_VIRTUAL_DISK_RANGE

Referensi VHD