Edit

IVMGuestOS::SuiteMask property

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Retrieves the SuiteMask of the guest operating system running in the virtual machine.

This property is read-only.

Syntax

HRESULT get_SuiteMask(
  [out, retval] BSTR *suiteMask
);

Property value

The suite mask. The following string values are supported.

Value Meaning
"0x00000004"
 Microsoft BackOffice components are installed.
"0x00000400"
 Windows Server 2003, Web Edition is installed.
"0x00004000"
 Windows Server 2003, Compute Cluster Edition is installed.
"0x00000080"
 Windows Server 2008 R2 Datacenter, Windows Server 2008 Datacenter, Windows Server 2003, Datacenter Edition, or Windows 2000 Datacenter Server is installed.
"0x00000002"
 Windows Server 2008 R2 Enterprise, Windows Server 2008 Enterprise, Windows Server 2003, Enterprise Edition, or Windows 2000 Advanced Server is installed.
"0x00000040"
 Windows XP Embedded is installed.
"0x00000200"
 Windows Vista Home Premium, Windows Vista Home Basic, or Windows XP Home Edition is installed.
"0x00000100"
 Remote Desktop is supported, but only one interactive session is supported.
"0x00000001"
 Microsoft Small Business Server was once installed on the system, but may have been upgraded to another version of Windows.
"0x00000020"
 Microsoft Small Business Server is installed with the restrictive client license in force.
"0x00002000"
 Windows Storage Server 2003 R2 or Windows Storage Server 2003 is installed.
"0x00000010"
 Remote Desktop Services is installed. This value is always set.
"0x00008000"
 Windows Home Server is installed.

Error codes

Name/value Meaning
S_OK
0
 The operation was successful.
E_POINTER
0x80004003
 The parameter is NULL.
VM_E_VM_NOT_RUNNING
0xA0040206
 The VM is not running.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Integration components are not installed in this VM.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.

Requirements

Requirement Value
Minimum supported client
 Windows 7 [desktop apps only]
Minimum supported server
 None supported
End of client support
 Windows 7
Product
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS is defined as 99fea0db-4880-499a-b6d8-73dff9bc91be

See also

IVMGuestOS

  • Last updated on