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