Fungsi GetVirtualDiskMetadata (virtdisk.h)

Mengambil metadata yang ditentukan dari disk virtual.

Sintaks

DWORD GetVirtualDiskMetadata(
  [in]      HANDLE     VirtualDiskHandle,
  [in]      const GUID *Item,
  [in, out] PULONG     MetaDataSize,
  [out]     PVOID      MetaData
);

Parameter

[in] VirtualDiskHandle

Menangani ke disk virtual yang terbuka.

[in] Item

Alamat GUID yang mengidentifikasi metadata yang akan diambil.

[in, out] MetaDataSize

Alamat ULONG. Pada input, nilai menunjukkan ukuran, dalam byte, dari buffer yang ditunjukkan oleh parameter MetaData . Pada output, nilai berisi ukuran, dalam byte, dari metadata yang diambil. Jika buffer terlalu kecil, API akan gagal dan mengembalikan ERROR_INSUFFICIENT_BUFFER, menempatkan ukuran yang diperlukan di ULONG dan buffer akan berisi awal metadata.

[out] MetaData

Alamat buffer tempat metadata akan disimpan.

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