Fonction IsOS (shlwapi.h)
Vérifie les systèmes d’exploitation et les fonctionnalités du système d’exploitation spécifiés.
Syntaxe
BOOL IsOS(
[in] DWORD dwOS
);
Paramètres
[in] dwOS
Type : DWORD
Valeur qui spécifie le système d’exploitation ou la fonctionnalité de système d’exploitation pour lequel case activée. L’une des valeurs suivantes (vous ne pouvez pas combiner de valeurs).
| Nom | Valeur | Description |
|---|---|---|
| OS_WINDOWS | 0 | Le programme s’exécute sur l’une des versions suivantes de Windows :
|
| OS_NT | 1 | Retourne toujours TRUE. |
| OS_WIN95ORGREATER | 2 | Retourne toujours FALSE. |
| OS_NT4ORGREATER | 3 | Retourne toujours FALSE. |
| OS_WIN98ORGREATER | 5 | Retourne toujours FALSE. |
| OS_WIN98_GOLD | 6 | Retourne toujours FALSE. |
| OS_WIN2000ORGREATER | 7 | Le programme s’exécute sur Windows 2000 ou l’un de ses successeurs. |
| OS_WIN2000PRO | 8 | N’utilisez pas ; utilisez OS_PROFESSIONAL. |
| OS_WIN2000SERVER | 9 | N’utilisez pas ; utilisez OS_SERVER. |
| OS_WIN2000ADVSERVER | 10 | N’utilisez pas ; utilisez OS_ADVSERVER. |
| OS_WIN2000DATACENTER | 11 | N’utilisez pas ; utilisez OS_DATACENTER. |
| OS_WIN2000TERMINAL | 12 | Le programme s’exécute sur Windows 2000 Terminal Server en mode Administration à distance ou Serveur d’applications, ou Windows Server 2003 (ou l’un de ses successeurs) en mode Terminal Server ou Bureau à distance pour administration. Envisagez d’utiliser une valeur plus spécifique telle que OS_TERMINALSERVER, OS_TERMINALREMOTEADMIN ou OS_PERSONALTERMINALSERVER. |
| OS_EMBEDDED | 13 | Le programme s’exécute sur Windows Embedded, n’importe quelle version. Équivalent à VER_SUITE_EMBEDDEDNT. |
| OS_TERMINALCLIENT | 14 | Le programme s’exécute en tant que client Terminal Server. Équivalent à GetSystemMetrics(SM_REMOTESESSION). |
| OS_TERMINALREMOTEADMIN | 15 | Le programme s’exécute sur Windows 2000 Terminal Server en mode Administration à distance ou Windows Server 2003 (ou l’un de ses successeurs) en mode Bureau à distance pour l’administration (il s’agit des modes d’installation par défaut). Cela équivaut à VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS. |
| OS_WIN95_GOLD | 16 | Retourne toujours FALSE. |
| OS_MEORGREATER | 17 | Retourne toujours FALSE. |
| OS_XPORGREATER | 18 | Retourne toujours FALSE. |
| OS_HOME | 19 | Retourne toujours FALSE. |
| OS_PROFESSIONAL | 20 | Le programme s’exécute sur Windows NT Workstation ou Windows 2000 (ou l’un de ses successeurs) Professionnel. Équivalent à VER_NT_WORKSTATION && VER_PLATFORM_WIN32_NT. |
| OS_DATACENTER | 21 | Le programme s’exécute sur Windows Datacenter Server ou Windows Server Datacenter Edition, n’importe quelle version. Équivalent à (VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER) && VER_SUITE_DATACENTER. |
| OS_ADVSERVER | 22 | Le programme s’exécute sur Windows Advanced Server ou Windows Server Êdition Entreprise, n’importe quelle version. Équivalent à (VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER) && VER_SUITE_ENTERPRISE && !VER_SUITE_DATACENTER. |
| OS_SERVER | 23 | Le programme s’exécute sur Windows Server (Standard) ou Windows Server Standard Edition, n’importe quelle version. Cette valeur ne retourne pas true pour VER_SUITE_DATACENTER, VER_SUITE_ENTERPRISE, VER_SUITE_SMALLBUSINESS ou VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TERMINALSERVER | 24 | Le programme s’exécute sur Windows 2000 Terminal Server en mode Serveur d’applications, ou sur Windows Server 2003 (ou l’un de ses successeurs) en mode Terminal Server. Cela équivaut à VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS. |
| OS_PERSONALTERMINALSERVER | 25 | Le programme s’exécute sur Windows XP (ou l’un de ses successeurs), Édition Familiale ou Professionnel. Cela équivaut à VER_SUITE_SINGLEUSERTS && ! VER_SUITE_TERMINAL. |
| OS_FASTUSERSWITCHING | 26 | La commutation rapide de l’utilisateur est activée. |
| OS_WELCOMELOGONUI | 27 | Retourne toujours FALSE. |
| OS_DOMAINMEMBER | 28 | L’ordinateur est joint à un domaine. |
| OS_ANYSERVER | 29 | Le programme s’exécute sur n’importe quel produit Windows Server. Équivalent à VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER. |
| OS_WOW6432 | 30 | Le programme est un programme 32 bits s’exécutant sur Windows 64 bits. |
| OS_WEBSERVER | 31 | Retourne toujours FALSE. |
| OS_SMALLBUSINESSSERVER | 32 | Le programme s’exécute sur Microsoft Small Business Server avec une licence cliente restrictive en vigueur. Équivalent à VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TABLETPC | 33 | Le programme est en cours d’exécution sur Windows XP Édition Tablet PC, ou l’un de ses successeurs. |
| OS_SERVERADMINUI | 34 | L’interface utilisateur de l’administrateur doit être présentée à l’utilisateur. Il est possible d’avoir une interface utilisateur d’administration de serveur sur un ordinateur autre que serveur. Cette valeur informe l’application que le profil d’un administrateur a été itinérant vers un autre serveur, et que l’interface utilisateur doit être appropriée pour un administrateur. Sinon, l’utilisateur affiche une combinaison de paramètres administrateur et non administrateur. |
| OS_MEDIACENTER | 35 | Le programme s’exécute sur Windows XP Édition Media Center ou sur l’un de ses successeurs. Équivalent à GetSystemMetrics(SM_MEDIACENTER). |
| OS_APPLIANCE | 36 | Le programme s’exécute sur Windows Appliance Server. |
Valeur retournée
Type : BOOL
Retourne une valeur différente de zéro si le système d’exploitation ou la fonctionnalité de système d’exploitation spécifié est détecté, sinon FALSE.
Remarques
Les valeurs ne sont pas fournies pour Windows Vista et Windows 7. Pour déterminer si l’un de ces systèmes d’exploitation est présent, utilisez VerifyVersionInfo.
Dans les versions de Windows antérieures à Windows Vista, IsOS n’a pas été exporté par nom ou déclaré dans un fichier d’en-tête public. Pour l’utiliser dans ces cas, vous devez utiliser GetProcAddress et demander l’ordinal 437 à partir de Shlwapi.dll pour obtenir un pointeur de fonction. Sous Windows Vista, IsOS est inclus dans Shlwapi.h, ce qui n’est pas nécessaire.
Lorsque vous faites référence à des produits serveur, « Windows Server » fait référence uniquement au serveur Standard Edition. Si tous les produits serveur sont couverts par un indicateur particulier, il est explicitement indiqué dans le tableau.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server, Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |