Fungsi SetVirtualDiskInformation (virtdisk.h)

Mengatur informasi tentang hard disk virtual (VHD).

Sintaks

DWORD SetVirtualDiskInformation(
  [in] HANDLE                 VirtualDiskHandle,
  [in] PSET_VIRTUAL_DISK_INFO VirtualDiskInfo
);

Parameter

[in] VirtualDiskHandle

Handel ke disk virtual terbuka, yang harus dibuka menggunakan bendera VIRTUAL_DISK_ACCESS_METAOPS . Untuk informasi tentang cara membuka disk virtual, lihat fungsi OpenVirtualDisk .

[in] VirtualDiskInfo

Penunjuk ke struktur SET_VIRTUAL_DISK_INFO yang valid.

Nilai kembali

Status permintaan.

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Keterangan

Fungsi SetVirtualDiskInformation akan gagal jika anggota ParentFilePath diminta untuk diatur tetapi sistem tidak dapat menyelesaikan jalur yang disediakan.

Mengatur informasi induk juga akan menyebabkan bidang GUID dan Tanda Waktu induk anak diperbarui.

Disk virtual tidak dapat dilampirkan saat operasi ini sedang berlangsung.

Pemanggil harus memiliki READ|Akses TULIS ke penyimpanan backing untuk disk virtual.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	virtdisk.h
Pustaka	VirtDisk.lib
DLL	VirtDisk.dll

Lihat juga

Tentang VHD

Referensi VHD