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 qual recurso do sistema operacional ou do sistema operacional deve ser verificado. Um dos valores a seguir (você não pode combinar valores).

Nome	Value	Description
OS_WINDOWS	0	O programa está em execução em uma das seguintes versões do Windows: janelas 95 janelas 98 Windows Me Equivalente a VER_PLATFORM_WIN32_WINDOWS. Observe que nenhum desses sistemas tem suporte no momento. OS_WINDOWS retorna FALSE em todos os sistemas com suporte.
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 do Servidor de Aplicativos, ou no Windows Server 2003 (ou um de seus sucessores) no modo Terminal Server 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 Á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 na Estação de Trabalho do Windows NT ou no Windows 2000 (ou um de seus sucessores) Professional. Equivalente a VER_PLATFORM_WIN32_NT & VER_NT_WORKSTATION.
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_NT_SERVER \|\| VER_NT_DOMAIN_CONTROLLER) & VER_SUITE_DATACENTER.
OS_ADVSERVER	22	O programa está em execução no Windows Advanced Server ou no Windows Server Enterprise Edition, em qualquer versão. Equivalente a (VER_NT_SERVER \|\| VER_NT_DOMAIN_CONTROLLER) && 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 do 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	vinte e cinco	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 alternância 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 à 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 perambulado para um não servidor e a interface do usuário deve ser apropriada para um administrador. Caso contrário, o usuário mostrará 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.

Valor de retorno

Tipo: BOOL

Retorna um valor diferente de zero se o recurso do sistema operacional ou do sistema operacional especificado for detectado, caso contrário, FALSE.

Observações

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.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
Header	shlwapi.h
Library	mincore_downlevel.lib
de DLL	Shlwapi.dll (versão 5.0 ou posterior)