Funzione IsOS (shlwapi.h)
Verifica la presenza di sistemi operativi e funzionalità del sistema operativo specificati.
Sintassi
BOOL IsOS(
[in] DWORD dwOS
);
Parametri
[in] dwOS
Tipo: DWORD
Valore che specifica la funzionalità del sistema operativo o del sistema operativo da verificare. Uno dei valori seguenti (non è possibile combinare i valori).
| Nome | Valore | Descrizione |
|---|---|---|
| OS_WINDOWS | 0 | Il programma è in esecuzione in una delle versioni seguenti di Windows:
|
| OS_NT | 1 | Restituisce sempre TRUE. |
| OS_WIN95ORGREATER | 2 | Restituisce sempre FALSE. |
| OS_NT4ORGREATER | 3 | Restituisce sempre FALSE. |
| OS_WIN98ORGREATER | 5 | Restituisce sempre FALSE. |
| OS_WIN98_GOLD | 6 | Restituisce sempre FALSE. |
| OS_WIN2000ORGREATER | 7 | Il programma è in esecuzione in Windows 2000 o uno dei suoi successori. |
| OS_WIN2000PRO | 8 | Non usare; usare OS_PROFESSIONAL. |
| OS_WIN2000SERVER | 9 | Non usare; usare OS_SERVER. |
| OS_WIN2000ADVSERVER | 10 | Non usare; usare OS_ADVSERVER. |
| OS_WIN2000DATACENTER | 11 | Non usare; usare OS_DATACENTER. |
| OS_WIN2000TERMINAL | 12 | Il programma è in esecuzione in Windows 2000 Terminal Server in modalità Amministrazione remota o server applicazioni o Windows Server 2003 (o uno dei suoi successori) in modalità Terminal Server o Desktop remoto per amministrazione. È consigliabile usare un valore più specifico, ad esempio OS_TERMINALSERVER, OS_TERMINALREMOTEADMIN o OS_PERSONALTERMINALSERVER. |
| OS_EMBEDDED | 13 | Il programma è in esecuzione in Windows Embedded, qualsiasi versione. Equivalente a VER_SUITE_EMBEDDEDNT. |
| OS_TERMINALCLIENT | 14 | Il programma è in esecuzione come client del server terminale. Equivalente a GetSystemMetrics(SM_REMOTESESSION). |
| OS_TERMINALREMOTEADMIN | 15 | Il programma è in esecuzione in Windows 2000 Terminal Server in modalità Amministrazione remota o Windows Server 2003 (o uno dei relativi successori) nella modalità Desktop remoto per amministrazione (queste sono le modalità di installazione predefinite). Equivale a VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS. |
| OS_WIN95_GOLD | 16 | Restituisce sempre FALSE. |
| OS_MEORGREATER | 17 | Restituisce sempre FALSE. |
| OS_XPORGREATER | 18 | Restituisce sempre FALSE. |
| OS_HOME | 19 | Restituisce sempre FALSE. |
| OS_PROFESSIONAL | 20 | Il programma è in esecuzione su Workstation Windows NT o Windows 2000 (o uno dei suoi successori) Professional. Equivalente a VER_PLATFORM_WIN32_NT && VER_NT_WORKSTATION. |
| OS_DATACENTER | 21 | Il programma è in esecuzione in Windows Datacenter Server o Windows Server Datacenter Edition, qualsiasi versione. Equivalente a (VER_NT_SERVER VER_NT_DOMAIN_CONTROLLER || ) && VER_SUITE_DATACENTER. |
| OS_ADVSERVER | 22 | Il programma è in esecuzione in Windows Advanced Server o Windows Server edizione Enterprise, qualsiasi versione. Equivalente a (VER_NT_SERVER VER_NT_DOMAIN_CONTROLLER || ) && VER_SUITE_ENTERPRISE && !VER_SUITE_DATACENTER. |
| OS_SERVER | 23 | Il programma è in esecuzione in Windows Server (Standard) o Windows Server Standard Edition, qualsiasi versione. Questo valore non restituirà true per VER_SUITE_DATACENTER, VER_SUITE_ENTERPRISE, VER_SUITE_SMALLBUSINESS o VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TERMINALSERVER | 24 | Il programma è in esecuzione in Windows 2000 Terminal Server in modalità Server applicazioni o in Windows Server 2003 (o uno dei relativi successori) in modalità Terminal Server. Equivale a VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS. |
| OS_PERSONALTERMINALSERVER | 25 | Il programma è in esecuzione in Windows XP (o uno dei suoi successori), Home Edition o Professional. Equivale a VER_SUITE_SINGLEUSERTS && ! VER_SUITE_TERMINAL. |
| OS_FASTUSERSWITCHING | 26 | Il passaggio rapido dell'utente è abilitato. |
| OS_WELCOMELOGONUI | 27 | Restituisce sempre FALSE. |
| OS_DOMAINMEMBER | 28 | Il computer viene aggiunto a un dominio. |
| OS_ANYSERVER | 29 | Il programma è in esecuzione in qualsiasi prodotto Windows Server. Equivalente a VER_NT_SERVER VER_NT_DOMAIN_CONTROLLER || . |
| OS_WOW6432 | 30 | Il programma è un programma a 32 bit in esecuzione in Windows a 64 bit. |
| OS_WEBSERVER | 31 | Restituisce sempre FALSE. |
| OS_SMALLBUSINESSSERVER | 32 | Il programma è in esecuzione in Microsoft Small Business Server con licenza client restrittiva in vigore. Equivalente a VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TABLETPC | 33 | Il programma è in esecuzione in Windows XP Tablet PC Edition o in uno dei suoi successori. |
| OS_SERVERADMINUI | 34 | L'utente deve essere presentato con l'interfaccia utente dell'amministratore. È possibile disporre dell'interfaccia utente amministrativa del server in un computer non server. Questo valore informa l'applicazione che il profilo di un amministratore ha eseguito il roaming in un server diverso da un server e l'interfaccia utente deve essere appropriata per un amministratore. In caso contrario, l'utente viene visualizzato un mix di impostazioni amministratore e nonadministrator. |
| OS_MEDIACENTER | 35 | Il programma è in esecuzione in Windows XP Media Center Edition o in uno dei suoi successori. Equivalente a GetSystemMetrics(SM_MEDIACENTER). |
| OS_APPLIANCE | 36 | Il programma è in esecuzione in Windows Appliance Server. |
Valore restituito
Tipo: BOOL
Restituisce un valore diverso da zero se viene rilevata la funzionalità del sistema operativo o del sistema operativo specificato, in caso contrario FALSE.
Commenti
I valori non vengono forniti per Windows Vista e Windows 7. Per determinare se sono presenti uno di questi sistemi operativi, usare VerifyVersionInfo.
Nelle versioni di Windows precedenti a Windows Vista, IsOS non è stato esportato per nome o dichiarato in un file di intestazione pubblica. Per usarlo in questi casi, è necessario usare GetProcAddress e richiedere ordinale 437 da Shlwapi.dll per ottenere un puntatore alla funzione. In Windows Vista, IsOS è incluso in Shlwapi.h e questo non è necessario.
Quando si fa riferimento ai prodotti server, "Windows Server" fa riferimento solo al server Standard Edition. Se tutti i prodotti server sono coperti da un particolare flag, viene chiamato in modo esplicito nella tabella.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
| Server minimo supportato | Windows 2000 Server, Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shlwapi.h |
| DLL | Shlwapi.dll (versione 5.0 o successiva) |