ivmvirtualmachineevents-onstatechange.md

title	description	ms.assetid	keywords	topic_type	api_name	api_location	api_type	ms.topic	ms.date
IVMVirtualMachineEvents OnStateChange method (VPCCOMInterfaces.h)	Receives notification that a virtual machine's state has changed. | IVMVirtualMachineEvents OnStateChange method (VPCCOMInterfaces.h)	1737bb5e-078d-4ebe-9558-de083aae1baa	OnStateChange method Virtual PC OnStateChange method Virtual PC , IVMVirtualMachineEvents interface IVMVirtualMachineEvents interface Virtual PC , OnStateChange method	apiref	IVMVirtualMachineEvents.OnStateChange	VPCCOMInterfaces.h	COM	reference	05/31/2018

IVMVirtualMachineEvents::OnStateChange method

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Receives notification that a virtual machine's state has changed.

Syntax

HRESULT OnStateChange(
  [in] VMVMState virtualMachineState
);

Parameters

virtualMachineState [in]

The new state of the virtual machine. For a list of values, see VMVMState.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method is called when the state for this virtual machine changes. The client program must implement this interface method to receive notification of the vmVirtualMachineEvent_StateChanged event originating from IVMVirtualMachine.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	None supported
End of client support	Windows 7
Product	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	DIID_IVMVirtualMachineEvents is defined as 9d84f560-bb67-4961-bd12-a4da780c67e4

See also

IVMVirtualMachineEvents