IVMGuestOS：：Restart 方法

  • 项目

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

重启来宾操作系统。

语法

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

parameters

inForced [in]

如果需要强制重启，则VARIANT_TRUE;否则VARIANT_FALSE。

outRestartTask [out， retval]

用于跟踪重启序列的完成进度的 IVMTask 对象。

返回值

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

返回代码/值 说明
S_OK
0
 操作成功。
E_POINTER
0x80004003
 outRestartTask 参数为 NULL。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。
VM_E_TIMED_OUT
0xA0040202
 操作未及时完成。
VM_E_VM_NOT_RUNNING
0xA0040206
 虚拟机 (VM) 必须运行才能执行此操作。
VM_E_VM_UNKNOWN
0xA0040207
 配置未知。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 此 VM 中未安装集成组件功能。

备注

可以通过返回的 IVMTask 对象的 Error 属性返回以下值。

错误代码 /值 说明
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) (0x80070005)
调用方必须对此 VM 具有执行访问权限。
HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED) (0x800704f7)
计算机已锁定，如果没有强制选项，则无法关闭。
HRESULT_FROM_WIN32(ERROR_NOT_READY) (0x80070015)
设备未准备就绪。
HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS) (0x8007045b)
系统关闭正在进行。

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
终止客户端支持
 Windows 7
产品
 Windows Virtual PC
标头
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS定义为 99fea0db-4880-499a-b6d8-73dff9bc91be

另请参阅

IVMGuestOS