IVMVirtualMachine::GuestOS property

  • Article

The GuestOS property contains the guest operating system for this virtual machine.

This property is read-only.

Syntax

HRESULT get_GuestOS(
  [out] IVMGuestOS **guestOS
);

VB 
VMVirtualMachine.GuestOS( _
  ByRef guestOS _
)

Property value

The VMGuestOS object associated with this virtual machine.

This property value is read-only.

Error codes

Name Meaning
S_OK
 The operation was successful.
E_POINTER
 The guestOS parameter is NULL.
VM_E_VM_UNKNOWN
 The configuration is unknown.
DISP_E_EXCEPTION
 An unexpected error has occurred.

Examples

The following example displays the name of the guest operating system installed in a VMVirtualMachine object.

Set objVS = CreateObject("VirtualServer.Application")
Set objVM = objVS.FindVirtualMachine("Windows Server 2003")
Set objGuest = objVM.GuestOS

Wscript.Echo "VM Name: " & objVM.Name
If objGuest.Name = 0 Then
  WScript.Echo "Operating System: [none]"
Else
  WScript.Echo "Operating System: " & objGuest.Name
End If

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

IVMVirtualMachine