Método IVMGuestOS::Restart

[O Computador 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).]

Reinicia o sistema operacional convidado.

Sintaxe

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

inForced [in]: VARIANT_TRUE se uma reinicialização forçada for necessária e VARIANT_FALSE caso contrário.
outRestartTask [out, retval]: Um objeto IVMTask usado para acompanhar o progresso da conclusão da sequência de reinicialização.

Esse método pode retornar um desses valores.

Retornar código/valor	Descrição
S_OK 0	A operação foi bem-sucedida.
E_POINTER 0x80004003	O parâmetro outRestartTask é NULL.
DISP_E_EXCEPTION 0x80020009	Ocorreu um erro inesperado.
VM_E_TIMED_OUT 0xA0040202	A operação não foi concluída em tempo hábil.
VM_E_VM_NOT_RUNNING 0xA0040206	A VM (máquina virtual) deve estar em execução para essa operação.
VM_E_VM_UNKNOWN 0xA0040207	A configuração é desconhecida.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	O recurso de componentes de integração não está instalado nesta VM.

Os valores a seguir podem ser retornados por meio da propriedade Error do objeto IVMTask retornado.

Código de erro /Valor	Descrição
`HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)` (0x80070005)	O chamador deve ter permissões de acesso de execução para essa VM.
`HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED)` (0x800704f7)	O computador está bloqueado e não pode ser desligado sem a opção forçar.
`HRESULT_FROM_WIN32(ERROR_NOT_READY)` (0x80070015)	O dispositivo não está pronto.
`HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS)` (0x8007045b)	Um desligamento do sistema está em andamento.

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