Fungsi ExpandVirtualDisk (virtdisk.h)

Meningkatkan ukuran hard disk virtual (VHD) tetap atau dapat diperluas secara dinamis.

Sintaks

DWORD ExpandVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in]           EXPAND_VIRTUAL_DISK_FLAG        Flags,
  [in]           PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

Parameter

[in] VirtualDiskHandle

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

[in] Flags

Harus nilai EXPAND_VIRTUAL_DISK_FLAG_NONE enumerasi EXPAND_VIRTUAL_DISK_FLAG .

[in] Parameters

Penunjuk ke struktur EXPAND_VIRTUAL_DISK_PARAMETERS valid yang berisi data parameter ekspansi.

[in, optional] Overlapped

Penunjuk opsional ke struktur TUMPANG TINDIH yang valid jika operasi asinkron diinginkan.

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 ExpandVirtualDisk melakukan operasi di tempat, dan karenanya tidak membuat disk virtual.

Operasi perluasan hanya valid untuk disk virtual tetap dan dapat diperluas dan akan membatalkan rantai disk virtual yang berbeda.

Memperluas disk virtual mengharuskan disk virtual dilepas selama operasi.

Pemanggil harus memiliki READ|AKSES TULIS ke penyimpanan cadangan untuk disk virtual.

Untuk disk virtual yang dapat diperluas, fungsi ExpandVirtualDisk mungkin tidak menghasilkan file yang lebih besar karena ukurannya virtual dan tidak akan benar-benar tumbuh secara fisik sampai digunakan.

Jika disk virtual dapat diperluas dan volume host tidak memiliki cukup ruang untuk ukuran baru, fungsi ExpandVirtualDisk tetap dapat berhasil. Penulisan di masa mendatang ke disk virtual mungkin gagal jika volume host kehabisan ruang saat disk virtual meluas.

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