共用方式為


ExpandVirtualDisk 函式 (virtdisk.h)

增加固定或動態擴充虛擬硬碟的大小, (VHD) 。

語法

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

參數

[in] VirtualDiskHandle

開啟之虛擬磁碟的句柄,必須使用 VIRTUAL_DISK_ACCESS_METAOPS 旗標開啟。 如需如何開啟虛擬磁碟的詳細資訊,請參閱 OpenVirtualDisk 函式。

[in] Flags

必須是EXPAND_VIRTUAL_DISK_FLAG列舉EXPAND_VIRTUAL_DISK_FLAG_NONE值。

[in] Parameters

包含擴充參數數據的有效 EXPAND_VIRTUAL_DISK_PARAMETERS 結構的指標。

[in, optional] Overlapped

如果需要異步操作,則為有效 OVERLAPPED 結構的選擇性指標。

傳回值

要求的狀態。

如果函式成功,傳回值 會ERROR_SUCCESS

如果函式失敗,則傳回值是錯誤碼。 如需詳細資訊,請參閱 系統錯誤碼

備註

ExpandVirtualDisk 函式會就地執行作業,因此不會建立虛擬磁碟。

展開作業僅適用於固定且可擴充的虛擬磁碟,而且會使差異虛擬磁碟鏈結失效。

展開虛擬磁碟需要在作業期間卸離虛擬磁碟。

呼叫端必須具有 READ|對虛擬磁碟備份儲存區的寫入存取權。

對於可擴充的虛擬磁碟, ExpandVirtualDisk 函式可能不會產生較大的檔案,因為大小是虛擬的,而且實際上不會實際成長,直到使用為止。

如果虛擬磁碟可擴充,而且主機磁碟區沒有足夠的空間供新大小使用, 則 ExpandVirtualDisk 函式仍然可以成功。 如果主機磁碟區在虛擬磁碟擴充時空間不足,未來對虛擬磁碟的寫入可能會失敗。

規格需求

需求
最低支援的用戶端 Windows 7
最低支援的伺服器 Windows Server 2008 R2
目標平台 Windows
標頭 virtdisk.h
程式庫 VirtDisk.lib
Dll VirtDisk.dll

另請參閱

關於 VHD

VHD 參考