IVMVirtualPC：：CreateFixedVirtualHardDisk 方法

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

建立固定大小的虛擬硬碟。

語法

HRESULT CreateFixedVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          long    size,
  [out, retval] IVMTask **diskTask
);

參數

imagePath [in]

新磁片映射檔的完整路徑。 如果資料夾不存在，將會建立包含的資料夾。

size [in]

影像的大小，以 MB 為單位。 大小上限為 2，088，960 MB (2040GB) 。

diskTask [out， retval]

用來追蹤映射建立的 IVMTask 物件。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼/值 描述
S_OK
0
 作業成功。
E_POINTER
0x80004003
 參數為 Null。
E_INVALIDARG
0x80000003
 size參數小於或等於 0。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)
0x80070003
 系統找不到 imagePath 參數所指定的路徑。
HRESULT_FROM_WIN32 (ERROR_INVALID_DRIVE)
0x8007000f
 imagePath參數指定的檔案位於 CD-ROM 或 DVD-ROM 上。
HRESULT_FROM_WIN32 (ERROR_INVALID_NAME)
0x8007007b
 imagePath參數包含不正確字元， (「*？： <> /|」) 。
HRESULT_FROM_WIN32 (ERROR_BAD_PATHNAME)
0x800700a1
 imagePath參數都會指定空白或相對路徑。 至少有一個參數必須是絕對路徑。
HRESULT_FROM_WIN32 (ERROR_BUFFER_OVERFLOW)
0x8007006f
 imagePath參數所指定的路徑太長。 路徑的長度必須小於 MAX_PATH ( 260) 個字元。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)
0x800700b7
 imagePath參數所參考的檔案已經存在。
HRESULT_FROM_WIN32 (ERROR_DISK_FULL)
0x80070070
 動態擴充虛擬硬碟映射在主機磁片區上至少需要 8 MB 可用。
VM_E_IMAGE_SIZE_TOO_LARGE
0xA0040683
 size參數必須小於 2，088，960 MB。 如果格式為 FAT16， 則 size 參數必須小於 2000 MB。
VM_E_IMAGE_SIZE_TOO_SMALL
0xA0040684
 未格式化和 FAT16 格式化的虛擬硬碟映射必須至少為 3 MB。 FAT32 格式化的虛擬硬碟映射至少必須是 514 MB。
VM_E_FILE_TOO_LARGE_FOR_VOLUME
0xA0040679
 主機磁片區無法支援這個大小的檔案。 FAT32 磁片區的檔案大小上限為 4 GB。 FAT16 磁片區的檔案大小上限為 2 GB。
VM_E_APP_SHUTTING_DOWN
0xA0040209
 應用程式開始關閉之後，就無法建立虛擬硬碟。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 處理器不支援硬體加速虛擬化 (HAV) 擴充功能。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
VPCOMInterfaces.h
IID
 IID_IVMVirtualPC定義為 236ba0d9-a24a-4292-a132-27c1421dfd01

另請參閱

IVMVirtualPC