IsOS-Funktion (shlwapi.h)
Überprüft die angegebenen Betriebssysteme und Betriebssystemfeatures.
Syntax
BOOL IsOS(
[in] DWORD dwOS
);
Parameter
[in] dwOS
Art: DWORD
Ein Wert, der angibt, nach welchem Betriebssystem oder Betriebssystemfeature gesucht werden soll. Einer der folgenden Werte (Sie können keine Werte kombinieren).
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| OS_WINDOWS | 0 | Das Programm wird unter einer der folgenden Versionen von Windows ausgeführt:
|
| 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 Anwendungsservermodus oder windows Server 2003 (oder einem seiner Nachfolger) im Terminalservermodus oder Remotedesktop im Verwaltungsmodus ausgeführt. Erwägen Sie, einen spezifischeren Wert wie OS_TERMINALSERVER, OS_TERMINALREMOTEADMIN oder OS_PERSONALTERMINALSERVER zu verwenden. |
| OS_EMBEDDED | 13 | Das Programm wird unter Windows Embedded ausgeführt, in beliebiger Version. 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 Remoteverwaltungsmodus oder windows Server 2003 (oder einem seiner Nachfolger) im Modus Remotedesktop für Verwaltung (dies sind die Standardinstallationsmodi) ausgeführt. 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 ausgeführt, einer beliebigen Version. 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 einer beliebigen Version ausgeführt. Entspricht (VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER) && VER_SUITE_ENTERPRISE && !VER_SUITE_DATACENTER. |
| OS_SERVER | 23 | Das Programm wird unter Windows Server (Standard) oder Windows Server Standard Edition, einer beliebigen Version, ausgeführt. Dieser Wert gibt für VER_SUITE_DATACENTER, VER_SUITE_ENTERPRISE, VER_SUITE_SMALLBUSINESS oder VER_SUITE_SMALLBUSINESS_RESTRICTED nicht true 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 mit einer Domäne verbunden. |
| 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 restriktiver Clientlizenz in Kraft ausgeführt. Entspricht VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TABLETPC | 33 | Das Programm wird auf Windows XP Tablet PC Edition oder einem seiner Nachfolger ausgeführt. |
| OS_SERVERADMINUI | 34 | Dem Benutzer sollte die Administrator-Benutzeroberfläche 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 zu einem Nicht-Server verschoben 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 unter 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.
Hinweise
Für Windows Vista und Windows 7 werden keine Werte bereitgestellt. Verwenden Sie VerifyVersionInfo, um zu bestimmen, ob eines dieser Betriebssysteme vorhanden ist.
In Windows-Versionen vor Windows Vista wurde IsOS nicht nach Namen exportiert oder in einer öffentlichen Headerdatei deklariert. Um es in diesen Fällen zu verwenden, müssen Sie GetProcAddress verwenden und die 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 durch ein bestimmtes Flag abgedeckt sind, wird es in der Tabelle explizit aufgerufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlwapi.h |
| DLL | Shlwapi.dll (Version 5.0 oder höher) |