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 |