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

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.

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.

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