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

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

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