Compartilhar via


Propriedade IVMGuestOS::HeartbeatPercentage

[O Pc Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Recupera o percentual de pulsações esperadas recebidas no último minuto.

Esta propriedade é somente para leitura.

Syntax

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

Valor da propriedade

A porcentagem de pulsações esperadas recebidas no último minuto.

Códigos de erro

Nome/valor Significado
S_OK
0
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro é NULL.
VM_E_VM_UNKNOWN
0xA0040207
A configuração é desconhecida.
VM_E_VM_NOT_RUNNING
0xA0040206
A VM (máquina virtual) deve estar em execução para essa operação.
VM_E_ADDITIONS_NOT_AVAIL
0xA0040504
A VM não está totalmente inicializada, o recurso de componentes de integração não está instalado ou a versão instalada não dá suporte a esse recurso.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

Comentários

Os componentes de integração enviarão uma pulsação periódica para o PC Virtual do Windows enquanto o sistema operacional convidado estiver em execução. Se o sistema operacional convidado estiver muito carregado, é possível que o PC Virtual do Windows receba menos pulsações do que o esperado. Se a porcentagem de pulsação cair para zero, é possível que o sistema operacional convidado não esteja respondendo ou tenha falha. A máquina virtual deve estar em execução (ou seja, totalmente inicializada e não está sendo fechada) e os componentes de integração devem ser instalados quando essa propriedade é invocada.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Fim do suporte ao cliente
Windows 7
Produto
Windows Virtual PC
Cabeçalho
VPCCOMInterfaces.h
IID
IID_IVMGuestOS é definido como 99fea0db-4880-499a-b6d8-73dff9bc91be

Confira também

IVMGuestOS