Proprietà IVMGuestOS::IsHeartbeating

2023-10-11

[Pc virtuale Windows non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Determina se la macchina virtuale ha un heartbeat.

Questa proprietà è di sola lettura.

Sintassi

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

Valore proprietà

VARIANT_TRUE se viene rilevato un heartbeat, VARIANT_FALedizione Standard in caso contrario.

Codici di errore

Nome/valore	Significato
S_OK 0	Operazione riuscita.
E_POINTER 0x80004003	Il parametro è NULL.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione è sconosciuta.
VM_E_VM_NOT_RUNNING 0xA0040206	La macchina virtuale deve essere in esecuzione per questa operazione.
VM_E_ADDITIONS_NOT_AVAIL 0xA0040504	La macchina virtuale non è completamente avviata, la funzionalità dei componenti di integrazione non è installata o la versione installata non supporta questa funzionalità.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Osservazioni:

Quando i componenti di integrazione vengono installati nel sistema operativo guest, viene inviato un normale "tick" o heartbeat dalla sessione della macchina virtuale al PC virtuale Windows. Se il sistema operativo guest viene caricato pesantemente, è possibile che il PC virtuale riceva meno heartbeat del previsto. Se non viene rilevato alcun heartbeat, è possibile che il sistema operativo guest non risponda o si arresti in modo anomalo.

Per impostazione predefinita, una macchina virtuale produce dieci tick heartbeat al minuto. Se non vengono rilevati tick di heartbeat per un intero minuto, il PC virtuale Windows tenterà di riavviare la sessione della macchina virtuale una volta ogni dieci secondi per un massimo di due minuti. Questo comportamento è controllato dai valori chiave seguenti nel file di configurazione della sessione della macchina virtuale.

Chiave di configurazione	Default	Descrizione
integration/microsoft/heartbeat/time	60	Durata del blocco di tempo usato per generare tick heartbeat, in secondi.
integration/microsoft/heartbeat/rate	10	Numero di tick generati in ogni blocco di tempo heartbeat.
integration/microsoft/heartbeat/failure_interval	10	Numero di secondi tra i tentativi di riavvio, quando non vengono ricevuti tick heartbeat all'interno di un blocco di tempo di heartbeat specifico.
integration/microsoft/heartbeat/failure_attempts	12	Numero di tentativi di riavvio effettuati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuna supportata
Fine del supporto client	Windows 7
Prodotto	Windows Virtual PC
Intestazione	VPCCOMInterfaces.h
IID	IID_IVMGuestOS è definito come 99fea0db-4880-499a-b6d8-73dff9bc91be

Vedi anche

IVMGuestOS