Função IsOS (shlwapi.h)
Verifica se há sistemas operacionais e recursos do sistema operacional especificados.
Sintaxe
BOOL IsOS(
[in] DWORD dwOS
);
Parâmetros
[in] dwOS
Tipo: DWORD
Um valor que especifica para qual sistema operacional ou recurso do sistema operacional marcar. Um dos valores a seguir (você não pode combinar valores).
| Nome | Valor | Descrição |
|---|---|---|
| OS_WINDOWS | 0 | O programa está em execução em uma das seguintes versões do Windows:
|
| OS_NT | 1 | Sempre retorna TRUE. |
| OS_WIN95ORGREATER | 2 | Sempre retorna FALSE. |
| OS_NT4ORGREATER | 3 | Sempre retorna FALSE. |
| OS_WIN98ORGREATER | 5 | Sempre retorna FALSE. |
| OS_WIN98_GOLD | 6 | Sempre retorna FALSE. |
| OS_WIN2000ORGREATER | 7 | O programa está em execução no Windows 2000 ou em um de seus sucessores. |
| OS_WIN2000PRO | 8 | Não use; use OS_PROFESSIONAL. |
| OS_WIN2000SERVER | 9 | Não use; use OS_SERVER. |
| OS_WIN2000ADVSERVER | 10 | Não use; use OS_ADVSERVER. |
| OS_WIN2000DATACENTER | 11 | Não use; use OS_DATACENTER. |
| OS_WIN2000TERMINAL | 12 | O programa está em execução no Servidor de Terminal do Windows 2000 no modo de Administração Remota ou no modo servidor de aplicativos ou no Windows Server 2003 (ou um de seus sucessores) no modo Servidor de Terminal ou área de trabalho remota para o modo administração. Considere usar um valor mais específico, como OS_TERMINALSERVER, OS_TERMINALREMOTEADMIN ou OS_PERSONALTERMINALSERVER. |
| OS_EMBEDDED | 13 | O programa está em execução no Windows Embedded, em qualquer versão. Equivalente a VER_SUITE_EMBEDDEDNT. |
| OS_TERMINALCLIENT | 14 | O programa está em execução como um cliente do Terminal Server. Equivalente a GetSystemMetrics(SM_REMOTESESSION). |
| OS_TERMINALREMOTEADMIN | 15 | O programa está em execução no Servidor de Terminal do Windows 2000 no modo de Administração Remota ou no Windows Server 2003 (ou um de seus sucessores) no modo de Área de Trabalho Remota para Administração (estes são os modos de instalação padrão). Isso é equivalente a VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS. |
| OS_WIN95_GOLD | 16 | Sempre retorna FALSE. |
| OS_MEORGREATER | 17 | Sempre retorna FALSE. |
| OS_XPORGREATER | 18 | Sempre retorna FALSE. |
| OS_HOME | 19 | Sempre retorna FALSE. |
| OS_PROFESSIONAL | 20 | O programa está em execução no Windows NT Workstation ou no Windows 2000 (ou um de seus sucessores) Professional. Equivalente a VER_PLATFORM_WIN32_NTVER_NT_WORKSTATION de && . |
| OS_DATACENTER | 21 | O programa está em execução no Windows Datacenter Server ou no Windows Server Datacenter Edition, em qualquer versão. Equivalente a VER_SUITE_DATACENTER (VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER) && . |
| OS_ADVSERVER | 22 | O programa está em execução no Windows Advanced Server ou no Windows Server Edição Enterprise, em qualquer versão. Equivalente a (VER_NT_DOMAIN_CONTROLLER || VER_NT_SERVER) && VER_SUITE_ENTERPRISE && !VER_SUITE_DATACENTER. |
| OS_SERVER | 23 | O programa está em execução no Windows Server (Standard) ou no Windows Server Standard Edition, em qualquer versão. Esse valor não retornará true para VER_SUITE_DATACENTER, VER_SUITE_ENTERPRISE, VER_SUITE_SMALLBUSINESS ou VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TERMINALSERVER | 24 | O programa está em execução no Servidor de Terminal do Windows 2000 no modo Servidor de Aplicativos ou no Windows Server 2003 (ou um de seus sucessores) no modo Terminal Server. Isso é equivalente a VER_SUITE_TERMINAL && VER_SUITE_SINGLEUSERTS. |
| OS_PERSONALTERMINALSERVER | 25 | O programa está em execução no Windows XP (ou um de seus sucessores), Home Edition ou Professional. Isso é equivalente a VER_SUITE_SINGLEUSERTS && ! VER_SUITE_TERMINAL. |
| OS_FASTUSERSWITCHING | 26 | A troca rápida de usuário está habilitada. |
| OS_WELCOMELOGONUI | 27 | Sempre retorna FALSE. |
| OS_DOMAINMEMBER | 28 | O computador é ingressado em um domínio. |
| OS_ANYSERVER | 29 | O programa está em execução em qualquer produto do Windows Server. Equivalente a VER_NT_SERVER || VER_NT_DOMAIN_CONTROLLER. |
| OS_WOW6432 | 30 | O programa é um programa de 32 bits em execução no Windows de 64 bits. |
| OS_WEBSERVER | 31 | Sempre retorna FALSE. |
| OS_SMALLBUSINESSSERVER | 32 | O programa está em execução no Microsoft Small Business Server com licença de cliente restritiva em vigor. Equivalente a VER_SUITE_SMALLBUSINESS_RESTRICTED. |
| OS_TABLETPC | 33 | O programa está em execução no Windows XP Tablet PC Edition ou em um de seus sucessores. |
| OS_SERVERADMINUI | 34 | O usuário deve ser apresentado com a interface do usuário do administrador. É possível ter a interface do usuário administrativa do servidor em um computador não servidor. Esse valor informa ao aplicativo que o perfil de um administrador foi movido para um não servidor e a interface do usuário deve ser apropriada para um administrador. Caso contrário, o usuário verá uma combinação de configurações de administrador e não administrador. |
| OS_MEDIACENTER | 35 | O programa está em execução no Windows XP Media Center Edition ou em um de seus sucessores. Equivalente a GetSystemMetrics(SM_MEDIACENTER). |
| OS_APPLIANCE | 36 | O programa está em execução no Windows Appliance Server. |
Retornar valor
Tipo: BOOL
Retornará um valor diferente de zero se o sistema operacional ou o recurso do sistema operacional especificado for detectado, caso contrário, FALSE.
Comentários
Os valores não são fornecidos para Windows Vista e Windows 7. Para determinar se um desses sistemas operacionais está presente, use VerifyVersionInfo.
Em versões do Windows anteriores ao Windows Vista, o IsOS não era exportado por nome ou declarado em um arquivo de cabeçalho público. Para usá-lo nesses casos, você deve usar GetProcAddress e solicitar o ordinal 437 de Shlwapi.dll para obter um ponteiro de função. No Windows Vista, o IsOS está incluído em Shlwapi.h e isso não é necessário.
Ao fazer referência a produtos de servidor, "Windows Server" refere-se apenas ao servidor Standard Edition. Se todos os produtos de servidor forem cobertos por um sinalizador específico, ele será chamado explicitamente na tabela.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlwapi.h |
| DLL | Shlwapi.dll (versão 5.0 ou posterior) |