IVMGuestOS::IsHeartbeating, propriété
[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 |
|---|---|
|
L'opération a réussi. |
|
Le paramètre est NULL. |
|
La configuration est inconnue. |
|
La machine virtuelle doit être en cours d’exécution pour cette opération. |
|
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é. |
|
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 |
|
| IID |
IID_IVMGuestOS est défini comme 99fea0db-4880-499a-b6d8-73dff9bc91be |