Compartilhar via

Método IVMGuestOS::Shutdown

  • Artigo

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

Desliga o sistema operacional convidado na VM (máquina virtual).

Sintaxe

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

Parâmetros

isForced [in]

VARIANT_TRUE se o desligamento for forçado, VARIANT_FALSE caso contrário.

outShutdownTask [out, retval]

Um objeto IVMTask usado para acompanhar a conclusão do processo de desligamento.

Valor retornado

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 outShutdownTask é NULL.
VM_E_TIMED_OUT
0xA0040202
 A operação não foi concluída em tempo hábil.
VM_E_VM_UNKNOWN
0xA0040207
 Não foi possível encontrar a VM.
VM_E_VM_NOT_RUNNING
0xA0040206
 A VM deve estar em execução para essa operação.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005
 O chamador deve ter permissões de acesso de execução para essa VM.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 O recurso de componentes de integração não está instalado nesta VM.
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.

Comentários

A VM deve estar em execução e o recurso de componentes de integração deve ser instalado quando esse método é invocado. Esse método só tem suporte para sistemas operacionais convidados baseados no Windows.

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.

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