IVMVirtualPC：：CreateDynamicVirtualHardDisk 方法

  • 项目

[自Windows 8起，Windows 虚拟电脑不再可供使用。 请改用 Hyper-V WMI 提供程序 (V2) 。]

创建动态调整虚拟硬盘的大小。

语法

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

parameters

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 参数指定的路径太长。 路径的长度必须小于 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
 参数 大小 必须小于 2，088，960 MB。 如果格式为 FAT16，则大小必须小于 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
标头
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC定义为 236ba0d9-a24a-4292-a132-27c1421dfd01

另请参阅

IVMVirtualPC