IVMVirtualMachine 接口

[自 Windows 8 起，Windows 虚拟电脑不再可用。 请改用 Hyper-V WMI 提供程序 (V2) 。]

定义虚拟机的接口。 IVMVirtualMachine 可以使用 IVMVirtualMachineEvents 传出接口通知客户端有关事件。 IVMVirtualMachine 对象是从 IVMVirtualPC 方法（如 CreateVirtualMachine、RegisterVirtualMachine 和 FindVirtualMachine）返回的。 还可以从 IVMVirtualPC：：VirtualMachines 属性返回的 IVMVirtualMachineCollection 对象 中检索 IVMVirtualMachine 对象。

成员

IVMVirtualMachine 接口继承自 IDispatch 接口。 IVMVirtualMachine 还具有以下类型的成员：

• 方法
• 属性

方法

IVMVirtualMachine 接口具有以下方法。

方法	说明
AddDVDROMDrive	将新的 CD 或 DVD 驱动器添加到虚拟机。
AddHardDiskConnection	将新的硬盘连接添加到虚拟机。
AddNetworkAdapter	将网络接口添加到虚拟机。
AttachUSBDevice	将 USB 设备连接到虚拟机。
DetachUSBDevice	从虚拟机释放 USB 设备。
DiscardSavedState	放弃已保存虚拟机的任何已保存状态信息。
DiscardUndoDisks	放弃虚拟撤消磁盘。
GetActivationValue	检索此虚拟机的指定激活设置的值。
GetConfigurationValue	检索此虚拟机的指定配置设置的值。
MergeUndoDisks	合并虚拟撤消磁盘。
暂停	暂停虚拟机。
RemoveActivationValue	删除此虚拟机的指定激活设置的值。
RemoveConfigurationValue	删除此虚拟机的指定配置设置的值。
RemoveDVDROMDrive	从虚拟机中删除指定的 CD 或 DVD 驱动器。
RemoveHardDiskConnection	从虚拟机中删除指定的硬盘连接。
RemoveNetworkAdapter	从虚拟机中删除网络接口。
重 置	重置虚拟机。
继续	恢复虚拟机。
保存	保存虚拟机状态。
SetActivationValue	设置此虚拟机的指定激活设置的值。
SetConfigurationValue	设置此虚拟机的指定配置设置的值。
StartCommunicationChannel	设置主机和来宾之间的信道。
启动	从“未初始化”或“已保存”状态启动虚拟机。
Startup2	使用高级选项从“未初始化”或“已保存”状态启动虚拟机。
TurnOff	关闭虚拟机。

属性

IVMVirtualMachine 接口具有以下属性。

属性	访问类型	说明
会计	只读	此虚拟机的会计。
AttachedDriveTypes	只读	一个数组，指示附加到虚拟机中每个位置的驱动器的类型。
BaseBoardSerialNumber	读取/写入	基板序列号。
BIOSGUID	读取/写入	BIOS GUID。
BIOSSerialNumber	读取/写入	BIOS 序列号。
ChassisAssetTag	读取/写入	机箱资产标记。
ChassisSerialNumber	读取/写入	机箱序列号。
ConfigID	只读	虚拟机的唯一标识符。
显示	只读	虚拟机的视频显示。
DVDROMDrives	只读	附加到虚拟机的 CD 和 DVD 驱动器的可枚举集合。
文件	只读	虚拟机配置的 .vmc 文件的完全限定路径。
FloppyDrives	只读	附加到虚拟机的软盘驱动器的可枚举集合。
GuestOS	只读	此虚拟机的来宾操作系统。
HardDiskConnections	只读	硬盘连接的可枚举集合。
Has3DNow	只读	指示处理器是否支持 3DNow 指令集。
HasMMX	只读	指示处理器是否支持 MMX 指令集。
Hassse	只读	指示处理器是否支持 SSE 指令集。
HasSSE2	只读	指示处理器是否支持 SSE2 指令集。
Keyboard	只读	虚拟机的键盘设备。
内存	读取/写入	虚拟机中的物理内存量（以 MB 为单位）。
鼠标	只读	虚拟机的鼠标设备。
名称	读取/写入	虚拟机配置的名称。
NetworkAdapters	只读	附加到虚拟机的 NIC 的可枚举集合。
说明	读取/写入	虚拟机的说明。
ParallelPorts	只读	并行端口的可枚举集合。
ProcessorSpeed	只读	处理器的速度，以兆赫为单位 (MHz) 。
RdpPipeName	只读	用于视频和输入的名为管道的 RDP 连接的名称。
SavedStateFilePath	只读	保存的状态文件的完整路径。
SerialPorts	只读	串行端口的可枚举集合。
ShutdownActionOnQuit	读取/写入	当 Windows 虚拟电脑退出时，要在此虚拟机上运行时要执行的操作。
State	只读	虚拟机的当前状态。
撤消	读取/写入	指示是否为连接到虚拟机的硬盘启用了撤消驱动器。
UndoAction	读取/写入	从来宾操作系统中关闭虚拟机时，要对所有撤消驱动器执行的默认操作。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
终止客户端支持	Windows 7
产品	Windows Virtual PC
标头	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine定义为 f7092aa1-33ed-4f78-a59f-c00adfc2edd7