IVMVirtualMachineEvents::OnRequestShutdown method

The OnRequestShutdown method is called when a shutdown has been requested.

Syntax

HRESULT OnRequestShutdown();

Parameters

This method has no parameters.

Return value

A 32-bit value that describes an error or warning.

Remarks

This method is called whenever the virtual machine session is about to shut down. The client program must implement this interface method to receive notification of the vmVirtualMachineEvent_RequestShutdown event originating from IVMVirtualMachine. Clients should set isAllowed to TRUE to allow the virtual machine to shut down, or FALSE to leave it turned on.

This event notification is sent only when the virtual machines session is about to shut down. Operating system shutdown routines, such as IVMGuestOS::Shutdown, do not fire this event directly unless they also attempt to perform a software power off of the virtual hardware.

Requirements

Product
Microsoft Virtual Server 2005 onWindows Server 2003
Download
Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header
VsComInterfaces.h

See also

IVMVirtualMachineEvents