Compartilhar via


Método IVMVirtualMachineEvents::OnRequestShutdown

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

Recebe a notificação de que uma solicitação de desligamento foi feita.

Sintaxe

HRESULT OnRequestShutdown();

Parâmetros

Esse método não tem parâmetros.

Valor retornado

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Esse método é chamado sempre que a sessão da máquina virtual está prestes a ser desligada. O programa cliente deve implementar esse método de interface para receber notificação do evento vmVirtualMachineEvent_RequestShutdown proveniente de IVMVirtualMachine.

Essa notificação de evento é enviada somente quando a sessão de máquinas virtuais está prestes a ser desligada. As rotinas de desligamento do sistema operacional, como IVMGuestOS::Shutdown, não disparam esse evento diretamente, a menos que também tentem executar uma energia de software fora do hardware virtual.

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
DIID_IVMVirtualMachineEvents é definido como 9d84f560-bb67-4961-bd12-a4da780c67e4

Confira também

IVMVirtualMachineEvents