Fungsi EnumerateVirtualDiskMetadata (virtdisk.h)

Menghitung metadata yang terkait dengan disk virtual.

Sintaks

DWORD EnumerateVirtualDiskMetadata(
  [in]      HANDLE VirtualDiskHandle,
  [in, out] PULONG NumberOfItems,
  [out]     GUID   *Items
);

Parameter

[in] VirtualDiskHandle

Menangani ke disk virtual yang terbuka.

[in, out] NumberOfItems

Alamat ULONG. Pada input, nilai menunjukkan jumlah elemen dalam buffer yang ditunjukkan oleh parameter Item . Pada output, nilai berisi jumlah item yang diambil. Jika buffer terlalu kecil, API akan gagal dan mengembalikan ERROR_INSUFFICIENT_BUFFER dan ULONG akan berisi ukuran buffer yang diperlukan.

[out] Items

Alamat buffer yang akan diisi dengan GUIDs yang mewakili metadata. Fungsi GetVirtualDiskMetadata dapat digunakan untuk mengambil data yang diwakili oleh setiap GUID.

Mengembalikan nilai

Status permintaan.

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika buffer yang diacu oleh parameter Item terlalu kecil, nilai yang dikembalikan ERROR_INSUFFICIENT_BUFFER.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Windows
Header	virtdisk.h (termasuk Windows.h)
Pustaka	VirtDisk.lib
DLL	VirtDisk.dll

Lihat juga

Fungsi VHD