IVMGuestOS::HeartbeatPercentage-Eigenschaft

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Ruft den Prozentsatz der erwarteten Takte ab, die in der letzten Minute empfangen wurden.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_HeartbeatPercentage(
  [out, retval] long *heartbeatPercentage
);

Eigenschaftswert

Der Prozentsatz der erwarteten Takte, die in der letzten Minute empfangen wurden.

Fehlercodes

Name/Wert Bedeutung
S_OK
0
 Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
 Der Parameter ist NULL.
VM_E_VM_UNKNOWN
0xA0040207
 Die Konfiguration ist unbekannt.
VM_E_VM_NOT_RUNNING
0xA0040206
 Der virtuelle Computer (VM) muss für diesen Vorgang ausgeführt werden.
VM_E_ADDITIONS_NOT_AVAIL
0xA0040504
 Der virtuelle Computer wird nicht vollständig gestartet, das Feature "Integrationskomponenten" ist nicht installiert, oder die installierte Version unterstützt dieses Feature nicht.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Integrationskomponenten senden einen regelmäßigen Heartbeat an Windows Virtual PC, während das Gastbetriebssystem ausgeführt wird. Wenn das Gastbetriebssystem stark geladen ist, ist es möglich, dass Windows Virtual PC weniger Takte erhält als erwartet. Wenn der Taktprozentsatz auf 0 sinkt, ist es möglich, dass das Gastbetriebssystem nicht reagiert oder abgestürzt ist. Der virtuelle Computer muss ausgeführt werden (d. h. vollständig gestartet und nicht heruntergefahren), und Integrationskomponenten müssen installiert werden, wenn diese Eigenschaft aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Ende des Supports (Client)
 Windows 7
Produkt
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS ist definiert als 99fea0db-4880-499a-b6d8-73dff9bc91be

Weitere Informationen

IVMGuestOS