IVMVirtualPC interface
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Defines the top-level Windows Virtual PC application object. All other Windows Virtual PC interface objects are retrieved through this object.
IVMVirtualPC can notify clients about events by using the IVMVirtualPCEvents outgoing interface.
Members
The IVMVirtualPC interface inherits from the IDispatch interface. IVMVirtualPC also has these types of members:
Methods
The IVMVirtualPC interface has these methods.
| Method | Description |
|---|---|
| CreateDifferencingVirtualHardDisk | Creates a differencing virtual hard disk. |
| CreateDynamicVirtualHardDisk | Creates a dynamically resizing virtual hard disk. |
| CreateFixedVirtualHardDisk | Creates a fixed-size virtual hard disk. |
| CreateFloppyDiskImage | Creates a floppy disk image file. |
| CreateVirtualMachine | Creates a new virtual machine configuration and retrieves the virtual machine object. |
| DeleteVirtualMachine | Deletes a virtual machine configuration. |
| FindVirtualMachine | Retrieves a virtual machine object that matches the requested configuration. |
| FindVirtualNetwork | Retrieves a virtual network object that matches the requested name. |
| GetConfigurationValue | Retrieves the value of the specified configuration setting. |
| GetDVDFiles | Retrieves an array of known DVD files. |
| GetFloppyDiskFiles | Retrieves an array of known virtual floppy disk files. |
| GetFloppyDiskImageType | Retrieves the type of an existing floppy disk image file. |
| GetHardDisk | Retrieves an object corresponding to an existing disk image file. |
| GetHardDiskFiles | Retrieves an array of known virtual hard disk files. |
| GetVirtualMachineFiles | Retrieves an array of known virtual machine configuration files. |
| RegisterVirtualMachine | Registers an existing virtual machine configuration and retrieves the virtual machine object. |
| RemoveConfigurationValue | Removes the value of the specified configuration setting. |
| SetConfigurationValue | Sets the value of the specified configuration setting. |
| UnregisterVirtualMachine | Unregisters a virtual machine configuration without deleting the configuration file. |
Properties
The IVMVirtualPC interface has these properties.
| Property | Access type | Description |
|---|---|---|
| DefaultVMConfigurationPath |
Read/write |
The default directory to be searched for available virtual machine configuration files. |
| HostInfo |
Read-only |
Information about the physical computer. |
| MaximumFloppyDrivesPerVM |
Read-only |
The maximum number of floppy drives per virtual machine. |
| MaximumMemoryPerVM |
Read-only |
The maximum allowable quantity of physical memory per virtual machine, in megabytes. |
| MaximumNetworkAdaptersPerVM |
Read-only |
The maximum number of networks interfaces per virtual machine. |
| MaximumNumberOfIDEBuses |
Read-only |
The maximum number of buses allowed for IDE. |
| MaximumParallelPortsPerVM |
Read-only |
The maximum number of parallel ports per virtual machine. |
| MaximumSerialPortsPerVM |
Read-only |
The maximum number of serial ports per virtual machine. |
| MinimumMemoryPerVM |
Read-only |
The minimum allowable quantity of physical memory per virtual machine, in megabytes. |
| Name |
Read-only |
The name of the Windows Virtual PC application. |
| SearchPaths |
Read/write |
The file system paths that are used to find files associated with Windows Virtual PC. |
| SuggestedMaximumMemoryPerVM |
Read-only |
The suggested maximum allowable quantity of physical memory per virtual machine, in megabytes, to avoid low memory conditions on the host. |
| Tasks |
Read-only |
A collection of tasks. |
| UnconnectedNetworkAdapters |
Read-only |
An enumerable collection of unconnected network interfaces. |
| UpTime |
Read-only |
The number of seconds the Windows Virtual PC application has been running. |
| USBDeviceCollection |
Read-only |
An enumerable collection of all USB devices connected to the host. |
| Version |
Read-only |
The version of this instance of Windows Virtual PC. |
| VirtualMachines |
Read-only |
An enumerable collection of virtual machines. |
| VirtualNetworks |
Read-only |
An enumerable collection of virtual networks. |
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_IVMVirtualPC is defined as 236ba0d9-a24a-4292-a132-27c1421dfd01 |