IVMVirtualPC：：RegisterVirtualMachine 方法

  • 项目

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

注册现有虚拟机配置并检索虚拟机对象。

语法

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

参数

configurationName [in]

要注册的虚拟机的名称。 名称长度不能超过 80 个字符，名称和路径的组合长度不能超过 MAX_PATH (260) 个字符。 指定的名称可能包含 .vmc 扩展名。 如果此参数为 NULL 或空字符串，则 configurationPath 参数必须指定配置文件的完整路径。

configurationPath [in]

包含现有配置文件的文件夹的路径。 如果 configurationName 参数为 NULL 或空字符串，则必须指定现有配置文件的完整路径。

virtualMachine [out， retval]

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

返回值

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

返回代码/值 说明
S_OK
0
 操作成功。
E_POINTER
0x80004003
 configurationName 或 configurationPath 参数无效，或 virtualMachine 为 NULL。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)
0x80070003
 系统找不到 configurationName 和 configurationPath 参数指定的路径。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 系统找不到 configurationName 和 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_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