Checks for specified operating systems and operating system features.

Syntax

BOOL IsOS(      
    DWORD dwOS
);

Parameters

dwOS

[in] A value that specifies which operating system or operating system feature to check for. One of the following values (you cannot combine multiple values).

Name	Value	Supported On	Description
OS_WINDOWS	0	Microsoft Windows 2000/Windows XP/Windows Server 2003	The program is not running on Microsoft Windows NT or one of its successors.
OS_NT	1	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows NT or one of its successors.
OS_WIN95ORGREATER	2	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 95 or one of its successors.
OS_NT4ORGREATER	3	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows NT 4.0 or one of its successors.
OS_WIN2000ORGREATER_ALT	4	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 or one of its successors. This value is obsolete. Use OS_WIN2000ORGREATER instead.
OS_WIN98ORGREATER	5	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 98 or one of its successors.
OS_WIN98_GOLD	6	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 98 exactly.
OS_WIN2000ORGREATER	7	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 or one of its successors.
OS_WIN2000PRO	8	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 Professional or Windows XP Professional.
OS_WIN2000SERVER	9	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 Server (Standard) or Windows Server 2003 Standard Edition.
OS_WIN2000ADVSERVER	10	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 Advanced Server or Windows Server 2003 Enterprise Edition.
OS_WIN2000DATACENTER	11	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 Datacenter Server or Windows Server 2003 Datacenter Edition.
OS_WIN2000TERMINAL	12	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 Terminal Server in either Remote Administration mode or Application Server mode, or Windows Server 2003 (or one of its successors) in Terminal Server mode or Remote Desktop for Administration mode.
OS_EMBEDDED	13	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows Embedded, any version.
OS_TERMINALCLIENT	14	Windows 2000/Windows XP/Windows Server 2003	The program is running as a Terminal Server client. Equivalent to GetSystemMetrics(SM_REMOTESESSION).
OS_TERMINALREMOTEADMIN	15	Windows 2000/Windows XP/Windows Server 2003	The program is running on Windows 2000 Terminal Server in Remote Administration mode or Windows Server 2003 (or one of its successors) in Remote Desktop for Administration mode.
OS_WIN95_GOLD	16	Windows 2000/Windows XP/Windows Server 2003	Windows 95 exactly.
OS_MEORGREATER	17	Windows XP/Windows Server 2003	The program is running on Windows Millennium Edition (Windows Me) or one of its successors.
OS_XPORGREATER	18	Windows XP/Windows Server 2003	The program is running on Windows XP or one of its successors.
OS_HOME	19	Windows XP/Windows Server 2003	The program is running on the Home Edition of Windows XP or one of its successors.
OS_PROFESSIONAL	20	Windows XP/Windows Server 2003	The program is running on Windows NT Workstation or Windows 2000 (or one of its successors) Professional.
OS_DATACENTER	21	Windows XP/Windows Server 2003	The program is running on Windows Datacenter Server or Windows Server Datacenter Edition, any version.
OS_ADVSERVER	22	Windows XP/Windows Server 2003	The program is running on Windows Advanced Server or Windows Server Enterprise Edition, any version.
OS_SERVER	23	Windows XP/Windows Server 2003	The program is running on Windows Server (Standard) or Windows Server Standard Edition, any version.
OS_TERMINALSERVER	24	Windows XP/Windows Server 2003	The program is running on Windows 2000 Terminal Server in Application Server mode, or on Windows Server 2003 (or one of its successors) in Terminal Server mode.
OS_PERSONALTERMINALSERVER	25	Windows XP/Windows Server 2003	The program is running on Windows XP (or one of its successors), Home Edition or Professional.
OS_FASTUSERSWITCHING	26	Windows XP/Windows Server 2003	Fast user switching is enabled.
OS_WELCOMELOGONUI	27	Windows XP/Windows Server 2003	The Welcome screen is used for logon.
OS_DOMAINMEMBER	28	Windows XP/Windows Server 2003	The computer is joined to a domain.
OS_ANYSERVER	29	Windows XP/Windows Server 2003	The program is running on any Windows Server product.
OS_WOW6432	30	Windows XP/Windows Server 2003	The program is a 32-bit program running on Microsoft Win64.
OS_WEBSERVER	31	Windows XP Service Pack 2 (SP2)/Windows Server 2003 Service Pack 1 (SP1)	The program is running on Windows Server 2003, Web Edition, or one of its successors.
OS_SMALLBUSINESSSERVER	32	Windows XP SP2/Windows Server 2003 SP1	The program is running on Microsoft Small Business Server with restrictive client license in force.
OS_TABLETPC	33	Windows XP SP1/Windows Server 2003	The program is running on Windows XP Tablet PC Edition, or one of its successors. Equivalent to GetSystemMetrics(SM_TABLETPC).
OS_SERVERADMINUI	34	Windows XP SP2/Windows Server 2003	The program should bias its defaults towards those suitable for server administrators.
OS_MEDIACENTER	35	Windows XP SP1/Windows Server 2003	The program is running on Windows XP Media Center Edition, or one of its successors. Equivalent to GetSystemMetrics(SM_MEDIACENTER).
OS_APPLIANCE	36	Windows XP SP2/Windows Server 2003 SP1	The program is running on Windows Appliance Server.

Return Value

Returns a nonzero value if the operating system or operating system feature is detected, otherwise FALSE.

Remarks

Note  This function is available through Windows XP and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

In Windows versions earlier than Windows Vista, IsOS was not exported by name or declared in a public header file. To use it in those cases, you must use GetProcAddress and request ordinal 437 from Shlwapi.dll to obtain a function pointer. Under Windows Vista, IsOS is included in Shlwapi.h and this is not necessary.

This function assumes the following operating system lineages.

Win32s->Windows 95->Windows 95 OSR2->Windows 98->Windows 98 SE->Windows Me

Windows NT 3.1->Windows NT 4->Windows 2000->Windows XP->Windows Server 2003

For example, when the table for dwOS specifies "Windows NT 4.0 or one of its successors", this means Windows NT 4.0, Windows 2000, Windows XP, or Windows Server 2003. For the purpose of determining lineage for this function, Windows XP Tablet PC Edition and Windows XP Media Center Edition are considered Windows XP.

When referring to server products, "Windows Server" refers only to the Standard Edition server. If all server products are covered by a particular flag, it is called out explicitly in the table.

Function Information

Minimum DLL Version	shlwapi.dll version 5.0 or later
Custom Implementation	No
Header	shlwapi.h
Import library	None
Minimum operating systems	Windows 2000, Windows 2000 Server, Windows Server 2003, Windows XP

See Also

GetSystemMetrics, VerifyVersionInfo