Export (0) Print
Expand All

IVMVirtualMachine interface

Windows Virtual PC

[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.

MethodDescription
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.

PropertyAccess typeDescription

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft