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