Share via


IVMGuestOS interface

The IVMGuestOS interface defines the guest operating system running inside a virtual machine. This interface allows you to interact with the Microsoft Additions running inside the guest operating system. The IVMGuestOS for a virtual machine can be retrieved using the IVMVirtualMachine::GuestOS property. Folder sharing is an experimental feature in Virtual Server 1.0 and may not function properly in all configurations.

Inheritance

The IVMGuestOS interface has been extended by the following interface:

Members

The IVMGuestOS interface inherits from the IDispatch interface. IVMGuestOS also has these types of members:

Methods

The IVMGuestOS interface has these methods.

Method Description
ExecuteCommand Executes the specified file in the guest operating system.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
InstallAdditions Locates and installs the latest Additions into the guest operating system.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
SetParameter Sets a configuration parameter inside the guest operating system.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
Shutdown Tells the guest operating system to shut down.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)

Properties

The IVMGuestOS interface has these properties.

Property Access type Description
AdditionsVersion
Read-only
The version of the Additions installed in the guest operating system.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
CanShutdown
Read-only
Indicates whether the guest operating system can be cleanly shut down.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
HeartbeatPercentage
Read-only
The percentage of expected heartbeats received over the past minute.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
IsHeartbeating
Read-only
Indicates whether the guest operating system appears to be alive.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
IsHostTimeSyncEnabled
Read/write
Specifies if the Additions in this virtual machine should synchronize the guest's clock with the host's clock.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)
OSName
Read-only
The name of the guest operating system running in the virtual machine.
(Inherited from IVMGuestOSVMGuestOSIVMGuestOS2VMGuestOS2)

Requirements

Product
Microsoft Virtual Server 2005 onWindows Server 2003
Download
Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header
VsComInterfaces.h

See also

IDispatch

Virtual Server Interfaces

IVMGuestOS2

IVMGuestOS Methods

IVMGuestOS Properties