通过

IVMGuestOS：：Shutdown 方法

  • 项目

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

关闭虚拟机中的来宾操作系统 (VM) 。

语法

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

参数

isForced [in]

如果 关闭是强制的， VARIANT_TRUE否则VARIANT_FALSE 。

outShutdownTask [out ， retval]

用于跟踪关闭过程的完成的 IVMTask 对象。

返回值

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

返回代码/值 说明
S_OK
0
 操作成功。
E_POINTER
0x80004003
 outShutdownTask 参数为 NULL。
VM_E_TIMED_OUT
0xA0040202
 操作未及时完成。
VM_E_VM_UNKNOWN
0xA0040207
 找不到 VM。
VM_E_VM_NOT_RUNNING
0xA0040206
 VM 必须为此操作运行。
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005
 调用方必须对此 VM 具有执行访问权限。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 此 VM 中未安装集成组件功能。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

注解

调用此方法时，必须安装 VM，并且必须安装集成组件功能。 此方法仅支持基于Windows的来宾操作系统。

可以通过返回的 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
标头
HTTPCOMInterfaces.h
IID
 IID_IVMGuestOS定义为 99fea0db-4880-499a-b6d8-73dff9bc91be

另请参阅

IVMGuestOS