Compartilhar via


Método IVMVirtualMachine::TurnOff

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

Desativa a máquina virtual.

Sintaxe

HRESULT TurnOff(
  [out, retval] IVMTask **turnOffTask
);

Parâmetros

turnOffTask [out, retval]

Um objeto IVMTask usado para acompanhar o progresso da conclusão da sequência de desativação da máquina virtual.

Valor retornado

Esse método pode retornar um desses valores.

Código/valor de retorno Descrição
S_OK
0
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro é NULL.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005
O chamador deve ter permissões de acesso de execução para desativar essa máquina virtual.
VM_E_VM_NOT_RUNNING
0xA0040206
A máquina virtual não está em execução.
VM_E_VM_UNKNOWN
0xA0040207
A configuração é desconhecida.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

Comentários

Esse método desativa a máquina virtual da mesma maneira que desligar a energia em um computador físico.

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_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Confira também

IVMVirtualMachine