Freigeben über


IsOS-Funktion (shlwapi.h)

Sucht nach angegebenen Betriebssystemen und Betriebssystemfeatures.

Syntax

BOOL IsOS(
  [in] DWORD dwOS
);

Die Parameter

[in] dwOS

Art: DWORD

Ein Wert, der angibt, auf welches Betriebssystem- oder Betriebssystemfeature überprüft werden soll. Einer der folgenden Werte (Werte können nicht kombiniert werden).

Name Wert Description
OS_WINDOWS 0 Das Programm wird in einer der folgenden Versionen von Windows ausgeführt:
  • Windows 95
  • Windows 98
  • Windows Me
Entspricht VER_PLATFORM_WIN32_WINDOWS. Beachten Sie, dass derzeit keine dieser Systeme unterstützt wird. OS_WINDOWS gibt FALSE auf allen unterstützten Systemen zurück.
OS_NT 1 Gibt immer TRUE zurück.
OS_WIN95ORGREATER 2 Gibt immer FALSE zurück.
OS_NT4ORGREATER 3 Gibt immer FALSE zurück.
OS_WIN98ORGREATER 5 Gibt immer FALSE zurück.
OS_WIN98_GOLD 6 Gibt immer FALSE zurück.
OS_WIN2000ORGREATER 7 Das Programm wird unter Windows 2000 oder einem seiner Nachfolger ausgeführt.
OS_WIN2000PRO 8 Nicht verwenden; verwenden Sie OS_PROFESSIONAL.
OS_WIN2000SERVER 9 Nicht verwenden; verwenden Sie OS_SERVER.
OS_WIN2000ADVSERVER 10 Nicht verwenden; verwenden Sie OS_ADVSERVER.
OS_WIN2000DATACENTER 11 Nicht verwenden; verwenden Sie OS_DATACENTER.
OS_WIN2000TERMINAL 12 Das Programm wird unter Windows 2000 Terminal Server entweder im Remoteverwaltungsmodus oder im Anwendungsservermodus oder windows Server 2003 (oder einem seiner Nachfolger) im Terminalservermodus oder remotedesktop für den Verwaltungsmodus ausgeführt. Erwägen Sie die Verwendung eines spezifischeren Werts wie OS_TERMINALSERVER, OS_TERMINALREMOTEADMIN oder OS_PERSONALTERMINALSERVER.
OS_EMBEDDED 13 Das Programm wird unter Windows Embedded, jeder Version, ausgeführt. Entspricht VER_SUITE_EMBEDDEDNT.
OS_TERMINALCLIENT 14 Das Programm wird als Terminalserverclient ausgeführt. Entspricht GetSystemMetrics(SM_REMOTESESSION).
OS_TERMINALREMOTEADMIN 15 Das Programm wird unter Windows 2000 Terminal Server im Remoteadministrationsmodus oder windows Server 2003 (oder einem seiner Nachfolger) im Remotedesktop für verwaltungsmodus ausgeführt (dies sind die Standardinstallationsmodi). Dies entspricht VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS.
OS_WIN95_GOLD 16 Gibt immer FALSE zurück.
OS_MEORGREATER 17 Gibt immer FALSE zurück.
OS_XPORGREATER 18 Gibt immer FALSE zurück.
OS_HOME 19 Gibt immer FALSE zurück.
OS_PROFESSIONAL 20 Das Programm wird auf Windows NT Workstation oder Windows 2000 (oder einem seiner Nachfolger) Professional ausgeführt. Entspricht VER_PLATFORM_WIN32_NT && VER_NT_WORKSTATION.
OS_DATACENTER 21 Das Programm wird unter Windows Datacenter Server oder Windows Server Datacenter Edition, jeder Version, ausgeführt. Entspricht (VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER) && VER_SUITE_DATACENTER.
OS_ADVSERVER 22 Das Programm wird unter Windows Advanced Server oder Windows Server Enterprise Edition, jeder Version, ausgeführt. Entspricht (VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER) && VER_SUITE_ENTERPRISE && !VER_SUITE_DATACENTER.
OS_SERVER 23 Das Programm wird auf Windows Server (Standard) oder Windows Server Standard Edition, jeder Version, ausgeführt. Dieser Wert gibt für VER_SUITE_DATACENTER, VER_SUITE_ENTERPRISE, VER_SUITE_SMALLBUSINESS oder VER_SUITE_SMALLBUSINESS_RESTRICTED nicht wahr zurück.
OS_TERMINALSERVER 24 Das Programm wird unter Windows 2000 Terminal Server im Anwendungsservermodus oder unter Windows Server 2003 (oder einem seiner Nachfolger) im Terminalservermodus ausgeführt. Dies entspricht VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS.
OS_PERSONALTERMINALSERVER 25 Das Programm wird unter Windows XP (oder einem seiner Nachfolger), Home Edition oder Professional ausgeführt. Dies entspricht VER_SUITE_SINGLEUSERTS && ! VER_SUITE_TERMINAL.
OS_FASTUSERSWITCHING 26 Der schnelle Benutzerwechsel ist aktiviert.
OS_WELCOMELOGONUI 27 Gibt immer FALSE zurück.
OS_DOMAINMEMBER 28 Der Computer ist einer Domäne beigetreten.
OS_ANYSERVER 29 Das Programm wird auf jedem Windows Server-Produkt ausgeführt. Entspricht VER_NT_SERVER VER_NT_DOMAIN_CONTROLLER || .
OS_WOW6432 30 Das Programm ist ein 32-Bit-Programm, das unter 64-Bit-Windows ausgeführt wird.
OS_WEBSERVER 31 Gibt immer FALSE zurück.
OS_SMALLBUSINESSSERVER 32 Das Programm wird auf Microsoft Small Business Server mit eingeschränkter Clientlizenz ausgeführt. Entspricht VER_SUITE_SMALLBUSINESS_RESTRICTED.
OS_TABLETPC 33 Das Programm wird unter Windows XP Tablet PC Edition oder einem seiner Nachfolger ausgeführt.
OS_SERVERADMINUI 34 Der Benutzer sollte der Administrator-UI angezeigt werden. Es ist möglich, eine Serververwaltungsbenutzeroberfläche auf einem Nicht-Servercomputer zu verwenden. Dieser Wert informiert die Anwendung darüber, dass das Profil eines Administrators auf einen Nicht-Server übertragen wurde, und die Benutzeroberfläche sollte für einen Administrator geeignet sein. Andernfalls wird dem Benutzer eine Mischung aus Administrator- und Nichtadministratoreinstellungen angezeigt.
OS_MEDIACENTER 35 Das Programm wird unter Windows XP Media Center Edition oder einem seiner Nachfolger ausgeführt. Entspricht GetSystemMetrics(SM_MEDIACENTER).
OS_APPLIANCE 36 Das Programm wird auf Windows Appliance Server ausgeführt.

Rückgabewert

Typ: BOOL-

Gibt einen Wert ungleich Null zurück, wenn das angegebene Betriebssystem- oder Betriebssystemfeature erkannt wird, andernfalls FALSE.

Bemerkungen

Werte werden für Windows Vista und Windows 7 nicht bereitgestellt. Um festzustellen, ob eines dieser Betriebssysteme vorhanden ist, verwenden Sie VerifyVersionInfo.

In Windows-Versionen vor Windows Vista wurde IsOS nicht anhand des Namens exportiert oder in einer öffentlichen Headerdatei deklariert. Um es in diesen Fällen zu verwenden, müssen Sie GetProcAddress verwenden und Ordnungszahl 437 von Shlwapi.dll anfordern, um einen Funktionszeiger abzurufen. Unter Windows Vista ist IsOS in Shlwapi.h enthalten und dies ist nicht erforderlich.

Bei Bezug auf Serverprodukte bezieht sich "Windows Server" nur auf den Standard Edition-Server. Wenn alle Serverprodukte von einer bestimmten Kennzeichnung abgedeckt werden, wird sie explizit in der Tabelle aufgerufen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps]
Zielplattform Fenster
Header shlwapi.h
Library mincore_downlevel.lib
DLL Shlwapi.dll (Version 5.0 oder höher)

Siehe auch

GetSystemMetrics

GetVersionEx

VerifyVersionInfo