IVMGuestOS::IsHeartbeating 属性

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

确定虚拟机是否具有检测信号。

此属性为只读。

语法

HRESULT get_IsHeartbeating(
  [out, retval] VARIANT_BOOL *heartBeating
);

属性值

如果检测到检测信号,则为VARIANT_TRUE,否则,为VARIANT_FALSE

错误代码

名称/值 含义
S_OK
0
此操作成功。
E_POINTER
0x80004003
参数为NULL
VM_E_VM_UNKNOWN
0xA0040207
配置未知。
VM_E_VM_NOT_RUNNING
0xA0040206
必须针对此操作运行虚拟机。
VM_E_ADDITIONS_NOT_AVAIL
0xA0040504
虚拟机未完全启动,未安装集成组件功能,或者安装的版本不支持此功能。
DISP_E_EXCEPTION
0x80020009
发生意外错误。

备注

在来宾操作系统中安装集成组件时,会从虚拟机会话向 Windows 虚拟电脑定期发送“时钟周期”或检测信号。 如果来宾操作系统负载过大,虚拟电脑可能会收到比预期少的检测信号。 如果未检测到检测信号,来宾操作系统可能无法响应或已崩溃。

默认情况下,虚拟机每分钟生成 10 个检测信号时钟周期。 如果整一分钟内未检测到检测信号时钟周期,Windows 虚拟电脑将尝试每十秒重启一次虚拟机会话,最多两分钟。 此行为由虚拟机会话配置文件中的以下键值控制。

配置密钥 默认 说明
integration/microsoft/heartbeat/time
60
用于生成检测信号时钟周期的时间块的长度(以秒为单位)。
integration/microsoft/heartbeat/rate
10
每个检测信号时间块中生成的时钟周期数。
integration/microsoft/heartbeat/failure_interval
10
尝试重启之间的秒数(在特定检测信号时间块内未收到检测信号时钟周期之后)。
integration/microsoft/heartbeat/failure_attempts
12
尝试的重启次数。

要求

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

另请参阅

IVMGuestOS