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
• Properties

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	VPCCOMInterfaces.h
IID	IID_IVMVirtualPC is defined as 236ba0d9-a24a-4292-a132-27c1421dfd01