IVMGuestOS 接口

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

定义在虚拟机内运行的来宾操作系统。 此接口允许你与来宾操作系统内运行的集成组件进行交互。 可以使用 IVMVirtualMachine：：GuestOS 属性检索虚拟机的 IVMGuestOS。

成员

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

• 方法
• 属性

方法

IVMGuestOS 接口具有以下方法。

方法	说明
GetOsVersionInfo	检索虚拟机中运行的来宾操作系统的版本信息。
GetParameter	检索来宾中的命名参数。
InstallIntegrationComponents	查找最新的集成组件并将其安装到来宾操作系统中。
IsUserLoggedOn	确定请求的会话是否存在。
注销	从来宾操作系统注销所有用户。
重启	重启来宾操作系统。
SetParameter	在来宾中设置命名参数。
关闭	关闭来宾操作系统。

属性

IVMGuestOS 接口具有以下属性。

属性	访问类型	说明
CanShutdown	只读	指示是否可以完全关闭来宾操作系统， (需要集成组件) 。
ComputerName	只读	虚拟机中运行的来宾操作系统的计算机名称。
CSDVersion	只读	虚拟机中运行的来宾操作系统的 CSDVersion。
HeartbeatPercentage	只读	过去一分钟收到的预期检测信号的百分比。
IntegrationComponentsVersion	只读	来宾操作系统中安装的集成组件的版本。
IsHeartbeating	只读	指示虚拟机是否具有检测信号。
IsHostTimeSyncEnabled	读取/写入	指示此虚拟机中的集成组件是否应将来宾的时钟与主机的时钟同步。
MultipleUserSessionsAllowed	只读	指示来宾操作系统中是否允许多个并发用户会话。
OSBuildNumber	只读	虚拟机中运行的来宾操作系统的内部版本号。
OSMajorVersion	只读	虚拟机中运行的来宾操作系统的主版本。
OSMinorVersion	只读	虚拟机中运行的来宾操作系统的次要版本。
OSName	只读	虚拟机中运行的来宾操作系统的名称。
OSPlatformId	只读	虚拟机中运行的来宾操作系统的平台标识符。
OSVersion	只读	虚拟机中运行的来宾操作系统的版本。
ProductType	只读	虚拟机中运行的来宾操作系统的产品类型。
ScreenLocked	只读	指示屏幕是否在来宾操作系统中锁定。
ServicePackMajor	只读	虚拟机中运行的来宾操作系统 Service Pack 的主版本。
ServicePackMinor	只读	虚拟机中运行的来宾操作系统的 Service Pack 的次要版本。
SuiteMask	只读	虚拟机中运行的来宾操作系统的 SuiteMask。
TerminalServerPort	只读	来宾操作系统中远程桌面服务使用的端口。
TerminalServicesInitialized	只读	来宾操作系统中终端服务初始化的状态。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
客户端支持终止	Windows 7
产品	Windows Virtual PC
标头	VPCCOMInterfaces.h
IID	IID_IVMGuestOS定义为 99fea0db-4880-499a-b6d8-73dff9bc91be