Função GetProductInfo (sysinfoapi.h)
Recupera o tipo de produto para o sistema operacional no computador local e mapeia o tipo para os tipos de produto compatíveis com o sistema operacional especificado.
Para recuperar informações de tipo de produto em versões do Windows antes dos sistemas operacionais mínimos com suporte especificados na seção Requisitos, use a função GetVersionEx . Você também pode usar a propriedade OperatingSystemSKU da classe WMI Win32_OperatingSystem .
Sintaxe
BOOL GetProductInfo(
[in] DWORD dwOSMajorVersion,
[in] DWORD dwOSMinorVersion,
[in] DWORD dwSpMajorVersion,
[in] DWORD dwSpMinorVersion,
[out] PDWORD pdwReturnedProductType
);
Parâmetros
[in] dwOSMajorVersion
O número de versão principal do sistema operacional. O valor mínimo é 6.
A combinação dos parâmetros dwOSMajorVersion, dwOSMinorVersion, dwSpMajorVersion e dwSpMinorVersion descreve a versão máxima do sistema operacional de destino para o aplicativo. Por exemplo, o Windows Vista e o Windows Server 2008 são a versão 6.0.0.0 e o Windows 7 e o Windows Server 2008 R2 são a versão 6.1.0.0. Todas as versões baseadas no Windows 10 serão listadas como versão 6.3.
[in] dwOSMinorVersion
O número de versão secundária do sistema operacional. O valor mínimo é 0.
[in] dwSpMajorVersion
O número de versão principal do service pack do sistema operacional. O valor mínimo é 0.
[in] dwSpMinorVersion
O número da versão secundária do service pack do sistema operacional. O valor mínimo é 0.
[out] pdwReturnedProductType
O tipo de produto. Esse parâmetro não pode ser NULL. Se o sistema operacional especificado for menor que o sistema operacional atual, essas informações serão mapeadas para os tipos compatíveis com o sistema operacional especificado. Se o sistema operacional especificado for maior que o sistema operacional com suporte mais alto, essas informações serão mapeadas para os tipos compatíveis com o sistema operacional atual.
Esse parâmetro pode ser um dos seguintes valores (alguns produtos abaixo podem estar sem suporte).
| Valor | Significado |
|---|---|
|
Empresas |
|
Business N |
|
HPC Edition |
|
Servidor Hyper Core V |
|
Windows 10 Home |
|
Windows 10 Home China |
|
Windows 10 Home N |
|
Windows 10 Home Single Language |
|
Server Datacenter (instalação de avaliação) |
|
Server Datacenter, canal Semi-Annual (instalação principal) |
|
Server Standard, canal Semi-Annual (instalação principal) |
|
Datacenter do Servidor (instalação completa. Para instalações server core do Windows Server 2012 e posterior, use o método , Determinando se o Server Core está em execução.) |
|
Server Datacenter (instalação principal, Windows Server 2008 R2 e anterior) |
|
Server Datacenter sem Hyper-V (instalação principal) |
|
Server Datacenter sem Hyper-V (instalação completa) |
|
Windows 10 Education |
|
Windows 10 Education N |
|
Windows 10 Enterprise |
|
Windows 10 Enterprise E |
|
Windows 10 Enterprise Evaluation |
|
Windows 10 Enterprise N |
|
Avaliação do Windows 10 Enterprise N |
|
Windows 10 Enterprise 2015 LTSB |
|
Avaliação do LTSB Windows 10 Enterprise 2015 |
|
Windows 10 Enterprise 2015 LTSB N |
|
Avaliação do WINDOWS 10 ENTERPRISE 2015 LTSB N |
|
Server Enterprise (instalação completa) |
|
Server Enterprise (instalação principal) |
|
Server Enterprise sem Hyper-V (instalação principal) |
|
Server Enterprise para sistemas baseados em Itanium |
|
Server Enterprise sem Hyper-V (instalação completa) |
|
Solução do Windows Essential Server Adicional |
|
SVC adicional da solução do Windows Essential Server |
|
Gerenciamento de Soluções do Windows Essential Server |
|
SVC do Gerenciamento de Soluções do Windows Essential Server |
|
Home Basic |
|
Sem suporte |
|
Home Basic N |
|
Home Premium |
|
Sem suporte |
|
Home Premium N |
|
Windows Home Server 2011 |
|
Windows Storage Server 2008 R2 Essentials |
|
Microsoft Hyper-V Server |
|
Windows IoT Enterprise |
|
Windows IoT Enterprise LTSC |
|
Windows 10 IoT Core |
|
Windows 10 IoT Core Comercial |
|
Servidor de Gerenciamento do Windows Essential Business Server |
|
Windows Essential Business Server Messaging Server |
|
Servidor de Segurança do Windows Essential Business Server |
|
Windows 10 Mobile |
|
Windows 10 Mobile Enterprise |
|
Windows MultiPoint Server Premium (instalação completa) |
|
Windows MultiPoint Server Standard (instalação completa) |
|
Windows 10 Team |
|
Windows 10 Pro Education |
|
Windows 10 Pro for Workstations |
|
Windows 10 Pro para Estações de Trabalho N |
|
Windows 10 Pro |
|
Sem suporte |
|
Windows 10 Pro N |
|
Profissional com o Media Center |
|
Windows Small Business Server 2011 Essentials |
|
Server For SB Solutions EM |
|
Server For SB Solutions |
|
Server For SB Solutions EM |
|
Windows Server 2008 para Soluções do Windows Essential Server |
|
Windows Server 2008 sem Hyper-V para Soluções do Windows Essential Server |
|
Server Foundation |
|
Windows 10 Enterprise para Áreas de Trabalho Virtuais |
|
Windows Small Business Server |
|
Small Business Server Premium |
|
Small Business Server Premium (instalação principal) |
|
Windows MultiPoint Server |
|
Server Standard (instalação de avaliação) |
|
Server Standard (instalação completa. Para instalações server core do Windows Server 2012 e posterior, use o método , Determinando se o Server Core está em execução.) |
|
Server Standard (instalação principal, Windows Server 2008 R2 e anterior) |
|
Server Standard sem Hyper-V (instalação principal) |
|
Servidor Standard sem Hyper-V |
|
Soluções de servidor Premium |
|
Soluções de Servidor Premium (instalação principal) |
|
Inicial |
|
Sem suporte |
|
Starter N |
|
Servidor de Armazenamento Enterprise |
|
Storage Server Enterprise (instalação principal) |
|
Storage Server Express |
|
Storage Server Express (instalação principal) |
|
Servidor de Armazenamento Standard (instalação de avaliação) |
|
Servidor de Armazenamento Standard |
|
Servidor de Armazenamento Standard (instalação principal) |
|
Grupo de Trabalho do Servidor de Armazenamento (instalação de avaliação) |
|
Grupo de Trabalho do Servidor de Armazenamento |
|
Grupo de Trabalho do Servidor de Armazenamento (instalação principal) |
|
Ultimate |
|
Sem suporte |
|
Ultimate N |
|
Um produto desconhecido |
|
Servidor Web (instalação completa) |
|
Servidor Web (instalação principal) |
Valor retornado
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Essa função falhará se um dos parâmetros de entrada for inválido.
Comentários
Para detectar se uma função de servidor ou recurso está instalado, use o provedor WMI de Recurso do Servidor .
As versões subsequentes do Windows mapearão os tipos de produto compatíveis com o conjunto de tipos de produtos compatíveis com cada versão anterior com suporte do Windows, de volta à versão 6.0.0.0. Portanto, um aplicativo que faz um teste de igualdade para qualquer um desses valores continuará funcionando em versões futuras, mesmo quando novos tipos de produto forem adicionados.
PRODUCT_*os valores de _SERVER_CORE não são retornados no Windows Server 2012 e posteriores. Por exemplo, a edição do servidor base, Server Datacenter, é usada para criar as duas opções de instalação diferentes: "servidor completo" e "servidor principal". Com o Windows Server 2012, GetProductInfo retornará PRODUCT_DATACENTER independentemente da opção usada durante a instalação do produto. Conforme observado acima, para instalações do Server Core do Windows Server 2012 e posteriores, use o método Determinando se o Server Core está em execução.
A tabela a seguir indica os tipos de produto introduzidos na versão 6.1.0.0 e o que serão mapeados se GetProductInfo for chamado com a versão 6.0.0.0 em um sistema 6.1.0.0.
| Novo para 6.1.0.0 | Valor retornado com 6.0.0.0 |
|---|---|
| PRODUCT_PROFESSIONAL | PRODUCT_BUSINESS |
| PRODUCT_PROFESSIONAL_N | PRODUCT_BUSINESS_N |
| PRODUCT_STARTER_N | PRODUCT_STARTER |
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Exemplos
Para obter um exemplo, consulte Obtendo a versão do sistema.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | sysinfoapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de