IVMVirtualMachine interface

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

Defines the interface for a virtual machine. IVMVirtualMachine can notify clients about events using the IVMVirtualMachineEvents outgoing interface. IVMVirtualMachine objects are returned from IVMVirtualPC methods such as CreateVirtualMachine, RegisterVirtualMachine, and FindVirtualMachine. You can also retrieve an IVMVirtualMachine object from the IVMVirtualMachineCollection object returned from the IVMVirtualPC::VirtualMachines property.

Members

The IVMVirtualMachine interface inherits from the IDispatch interface. IVMVirtualMachine also has these types of members:

• Methods
• Properties

Methods

The IVMVirtualMachine interface has these methods.

Method	Description
AddDVDROMDrive	Adds a new CD or DVD drive to the virtual machine.
AddHardDiskConnection	Adds a new hard disk connection to the virtual machine.
AddNetworkAdapter	Adds a network interface to the virtual machine.
AttachUSBDevice	Attaches a USB device to a virtual machine.
DetachUSBDevice	Releases a USB device from a virtual machine.
DiscardSavedState	Discards any saved state information for a saved virtual machine.
DiscardUndoDisks	Discards the virtual undo disks.
GetActivationValue	Retrieves the value of the specified activation setting for this virtual machine.
GetConfigurationValue	Retrieves the value of the specified configuration setting for this virtual machine.
MergeUndoDisks	Merges the virtual undo disks.
Pause	Pauses the virtual machine.
RemoveActivationValue	Removes the value of the specified activation setting for this virtual machine.
RemoveConfigurationValue	Removes the value of the specified configuration setting for this virtual machine.
RemoveDVDROMDrive	Removes the specified CD or DVD drive from the virtual machine.
RemoveHardDiskConnection	Removes the specified hard disk connection from the virtual machine.
RemoveNetworkAdapter	Removes a network interface from the virtual machine.
Reset	Resets the virtual machine.
Resume	Resumes the virtual machine.
Save	Saves the virtual machine state.
SetActivationValue	Sets the value of the specified activation setting for this virtual machine.
SetConfigurationValue	Sets the value of the specified configuration setting for this virtual machine.
StartCommunicationChannel	Sets up a communication channel between host and guest.
Startup	Starts the virtual machine from either the uninitialized or saved state.
Startup2	Starts the virtual machine from either the uninitialized or saved state, with advanced options.
TurnOff	Turns off the virtual machine.

Properties

The IVMVirtualMachine interface has these properties.

Property	Access type	Description
Accountant	Read-only	An accountant for this virtual machine.
AttachedDriveTypes	Read-only	An array indicating the type of drive attached to each location in the virtual machine.
BaseBoardSerialNumber	Read/write	The Base board serial number.
BIOSGUID	Read/write	The BIOS GUID.
BIOSSerialNumber	Read/write	The BIOS serial number.
ChassisAssetTag	Read/write	The Chassis asset tag.
ChassisSerialNumber	Read/write	The Chassis serial number.
ConfigID	Read-only	The unique identifier for the virtual machine.
Display	Read-only	The video display for the virtual machine.
DVDROMDrives	Read-only	An enumerable collection of CD and DVD drives attached to the virtual machine.
File	Read-only	The fully qualified path of the .vmc file for the virtual machine configuration.
FloppyDrives	Read-only	An enumerable collection of floppy drives attached to the virtual machine.
GuestOS	Read-only	The guest operating system for this virtual machine.
HardDiskConnections	Read-only	An enumerable collection of hard disk connections.
Has3DNow	Read-only	Indicates whether the processor supports the 3DNow instruction set.
HasMMX	Read-only	Indicates whether the processor supports the MMX instruction set.
HasSSE	Read-only	Indicates whether the processor supports the SSE instruction set.
HasSSE2	Read-only	Indicates whether the processor supports the SSE2 instruction set.
Keyboard	Read-only	The keyboard device for the virtual machine.
Memory	Read/write	The amount of physical memory in the virtual machine, in megabytes.
Mouse	Read-only	The mouse device for the virtual machine.
Name	Read/write	The name of the virtual machine configuration.
NetworkAdapters	Read-only	An enumerable collection of NICs attached to the virtual machine.
Notes	Read/write	The notes for the virtual machine.
ParallelPorts	Read-only	An enumerable collection of parallel ports.
ProcessorSpeed	Read-only	The speed of the processor, in megahertz (MHz).
RdpPipeName	Read-only	Name of the RDP connection named pipe used for video and input.
SavedStateFilePath	Read-only	The full path to the saved state file.
SerialPorts	Read-only	An enumerable collection of serial ports.
ShutdownActionOnQuit	Read/write	The action to be performed on this virtual machine if it is running when Windows Virtual PC is quit.
State	Read-only	The current state of the virtual machine.
Undoable	Read/write	Indicates whether the undo drives are enabled for hard disks connected to the virtual machine.
UndoAction	Read/write	The default action to be performed on all undo drives when the virtual machine is shut down from within the guest operating system.

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	IID_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7