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:
  • Windows 95
  • Windows 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 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)

Confira também

GetSystemMetrics

Getversionex

VerifyVersionInfo