IVMVirtualPC：：CreateVirtualMachine 方法

  • 项目

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

创建新的虚拟机配置并检索虚拟机对象。

语法

HRESULT CreateVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

parameters

configurationName [in]

要创建的虚拟机的名称。 名称长度不能超过 80 个字符，并且 VMC 和 VMCX 文件的名称和路径的总长度不能超过 MAX_PATH (260) 个字符。 创建配置文件时，文件扩展名 .vmc 和 .vmcx 将追加到虚拟机名称的末尾。 如果此参数为 NULL 或空字符串，则 configurationPath 参数必须指定 VMC 文件的完整路径。

configurationPath [in]

将包含 VMC 文件的文件夹的路径。 如果此文件夹不存在，则会创建该文件夹。 如果 configurationName 为 NULL 或空字符串，则必须指定新配置文件的完整路径。

virtualMachine [out， retval]

指向表示此虚拟机的新 IVMVirtualMachine 对象的指针。

返回值

此方法可以返回其中一个值。

返回代码/值 说明
S_OK
0
 操作成功。
E_POINTER
0x80004003
 configurationName 或 configurationPath 参数无效，或者 virtualMachine 参数为 NULL。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)
0x80070003
 系统找不到 configurationPath 参数指定的路径。
HRESULT_FROM_WIN32 (ERROR_INVALID_NAME)
0x8007007b
 configurationPath 参数包含无效字符 (“*？：<>/|”之一) 。
HRESULT_FROM_WIN32 (ERROR_BAD_PATHNAME)
0x800700a1
 configurationPath 参数指定空路径或相对路径。 绝对路径是必需的。
HRESULT_FROM_WIN32 (ERROR_BUFFER_OVERFLOW)
0x8007006f
 configurationName 和 configurationPath 参数指定的路径会导致路径太长。 路径的总长度必须小于 MAX_PATH ( 260) 个字符。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)
0x800700b7
 此位置已存在具有此名称的配置文件。
VM_E_CONFIG_NO_NAME
0xA0040400
 configurationName 参数为空。
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 configurationName 参数的长度超过 80 个字符。
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 configurationName 参数包含无效字符 (“*？：<>/|\”) 之一。
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 已经有一个虚拟机具有此名称。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 处理器不支持硬件加速虚拟化 (HAV) 扩展。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

备注

虚拟机名称不区分大小写，例如，“MyVM”和“myvm”是指同一虚拟机。

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
客户端支持终止
 Windows 7
产品
 Windows Virtual PC
标头
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC定义为 236ba0d9-a24a-4292-a132-27c1421dfd01

另请参阅

IVMVirtualPC