Share via

IVMGuestOS::IsHeartbeating, propriété

  • Article

[Windows Virtual PC n’est plus disponible à compter de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Détermine si la machine virtuelle a une pulsation.

Cette propriété est en lecture seule.

Syntaxe

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

Valeur de la propriété

VARIANT_TRUE si une pulsation est détectée ; sinon, VARIANT_FALSE.

Codes d’erreur

Nom/valeur Signification
S_OK
0
 L'opération a réussi.
E_POINTER
0x80004003
 Le paramètre est NULL.
VM_E_VM_UNKNOWN
0xA0040207
 La configuration est inconnue.
VM_E_VM_NOT_RUNNING
0xA0040206
 La machine virtuelle doit être en cours d’exécution pour cette opération.
VM_E_ADDITIONS_NOT_AVAIL
0xA0040504
 La machine virtuelle n’est pas entièrement démarrée, la fonctionnalité des composants d’intégration n’est pas installée ou la version installée ne prend pas en charge cette fonctionnalité.
DISP_E_EXCEPTION
0x80020009
 Une erreur inattendue s’est produite.

Notes

Lorsque des composants d’intégration sont installés dans le système d’exploitation invité, une pulsation régulière (ou « cycle ») est envoyée de la session de machine virtuelle à Windows Virtual PC. Si le système d’exploitation invité est fortement chargé, il est possible que Virtual PC reçoive moins de pulsations que prévu. Si aucune pulsation n’est détectée, il est possible que le système d’exploitation invité ne réponde pas ou soit bloqué.

Par défaut, une machine virtuelle produit dix cycles de pulsation par minute. Si aucun cycle de pulsation n’est détecté pendant une minute entière, Windows Virtual PC tente de redémarrer la session de la machine virtuelle une fois toutes les dix secondes pendant deux minutes maximum. Ce comportement est contrôlé par les valeurs clés suivantes dans le fichier de configuration de la session de machine virtuelle.

Clé de configuration Default Description
integration/microsoft/heartbeat/time
 60
 Durée du bloc de temps utilisé pour générer des cycles de pulsation, en secondes.
integration/microsoft/heartbeat/rate
 10
 Nombre de cycles générés dans chaque bloc de temps de pulsation.
integration/microsoft/heartbeat/failure_interval
 10
 Nombre de secondes entre les tentatives de redémarrage, lorsqu’aucun cycle de pulsation n’est reçu dans un bloc de temps de pulsation spécifique.
integration/microsoft/heartbeat/failure_attempts
 12
 Nombre de tentatives de redémarrage effectuées.

Spécifications

Condition requise Value
Client minimal pris en charge
 Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge
 Aucun pris en charge
Fin du support client
 Windows 7
Produit
 Windows Virtual PC
En-tête
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS est défini comme 99fea0db-4880-499a-b6d8-73dff9bc91be

Voir aussi

IVMGuestOS