Función GetProductInfo (sysinfoapi.h)
Recupera el tipo de producto del sistema operativo en el equipo local y asigna el tipo a los tipos de producto admitidos por el sistema operativo especificado.
Para recuperar información de tipo de producto en versiones de Windows anteriores a los sistemas operativos mínimos admitidos especificados en la sección Requisitos, use la función GetVersionEx . También puede usar la propiedad OperatingSystemSKU de la Win32_OperatingSystem clase WMI.
Sintaxis
BOOL GetProductInfo(
[in] DWORD dwOSMajorVersion,
[in] DWORD dwOSMinorVersion,
[in] DWORD dwSpMajorVersion,
[in] DWORD dwSpMinorVersion,
[out] PDWORD pdwReturnedProductType
);
Parámetros
[in] dwOSMajorVersion
Número de versión principal del sistema operativo. El valor mínimo es 6.
La combinación de los parámetros dwOSMajorVersion, dwOSMinorVersion, dwSpMajorVersion y dwSpMinorVersion describe la versión máxima del sistema operativo de destino para la aplicación. Por ejemplo, Windows Vista y Windows Server 2008 son la versión 6.0.0.0 y Windows 7 y Windows Server 2008 R2 son la versión 6.1.0.0. Todas las versiones basadas en Windows 10 se mostrarán como la versión 6.3.
[in] dwOSMinorVersion
Número de versión secundaria del sistema operativo. El valor mínimo es 0.
[in] dwSpMajorVersion
Número de versión principal del Service Pack del sistema operativo. El valor mínimo es 0.
[in] dwSpMinorVersion
Número de versión secundaria del service pack del sistema operativo. El valor mínimo es 0.
[out] pdwReturnedProductType
Tipo de producto. Este parámetro no puede ser NULL. Si el sistema operativo especificado es menor que el sistema operativo actual, esta información se asigna a los tipos admitidos por el sistema operativo especificado. Si el sistema operativo especificado es mayor que el sistema operativo admitido más alto, esta información se asigna a los tipos admitidos por el sistema operativo actual.
Este parámetro puede ser uno de los siguientes valores (algunos productos siguientes pueden no ser compatibles).
| Value | Significado |
|---|---|
|
Business |
|
Negocio N |
|
HPC Edition |
|
Server Hyper Core V |
|
Windows 10 Home |
|
Windows 10 Home China |
|
Windows 10 Home N |
|
Windows 10 Home Single Language |
|
Centro de datos del servidor (instalación de evaluación) |
|
Centro de datos del servidor, canal de Semi-Annual (instalación principal) |
|
Server Standard, canal de Semi-Annual (instalación principal) |
|
Centro de datos del servidor (instalación completa. Para las instalaciones server Core de Windows Server 2012 y versiones posteriores, use el método Determinar si Server Core se está ejecutando). |
|
Server Datacenter (instalación principal, Windows Server 2008 R2 y versiones anteriores) |
|
Centro de datos de servidor sin Hyper-V (instalación principal) |
|
Centro de datos de servidor sin Hyper-V (instalación completa) |
|
Windows 10 Education |
|
Windows 10 Education N |
|
Windows 10 Enterprise |
|
Windows 10 Enterprise E |
|
Windows 10 Enterprise Evaluation |
|
Windows 10 Enterprise N |
|
evaluación de Windows 10 Enterprise N |
|
Windows 10 Enterprise 2015 LTSB |
|
evaluación de Windows 10 Enterprise 2015 LTSB |
|
Windows 10 Enterprise 2015 LTSB N |
|
Evaluación de Windows 10 Enterprise 2015 LTSB N |
|
Server Enterprise (instalación completa) |
|
Server Enterprise (instalación principal) |
|
Server Enterprise sin Hyper-V (instalación principal) |
|
Server Enterprise para sistemas basados en Itanium |
|
Server Enterprise sin Hyper-V (instalación completa) |
|
Solución de Windows Essential Server adicional |
|
Solución de Windows Essential Server Adicional SVC |
|
Administración de soluciones de Windows Essential Server |
|
Windows Essential Server Solution Management SVC |
|
Home Basic |
|
No compatible |
|
Inicio Básico N |
|
Home Premium |
|
No compatible |
|
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 administración de Windows Essential Business Server |
|
Servidor de mensajería de Windows Essential Business Server |
|
Servidor de seguridad de Windows Essential Business Server |
|
Windows 10 Mobile |
|
Windows 10 Mobile Enterprise |
|
Windows MultiPoint Server Premium (instalación completa) |
|
Windows MultiPoint Server Standard (instalación completa) |
|
Windows 10 Team |
|
Windows 10 Pro Education |
|
Windows 10 Pro for Workstations |
|
Windows 10 Pro for Workstations N |
|
Windows 10 Pro |
|
No compatible |
|
Windows 10 Pro N |
|
Profesional con Media Center |
|
Windows Small Business Server 2011 Essentials |
|
Servidor para SB Solutions EM |
|
Server For SB Solutions |
|
Servidor para SB Solutions EM |
|
Windows Server 2008 para soluciones de Windows Essential Server |
|
Windows Server 2008 sin Hyper-V para soluciones de Windows Essential Server |
|
Server Foundation |
|
Windows 10 Enterprise para Escritorios virtuales |
|
Windows Small Business Server |
|
Small Business Server Premium |
|
Small Business Server Premium (instalación principal) |
|
Windows MultiPoint Server |
|
Server Standard (instalación de evaluación) |
|
Server Standard (instalación completa. Para las instalaciones de Server Core de Windows Server 2012 y versiones posteriores, use el método Determinación de si Server Core se está ejecutando). |
|
Server Standard (instalación básica, Windows Server 2008 R2 y versiones anteriores) |
|
Server Standard sin Hyper-V (instalación principal) |
|
Server Standard sin Hyper-V |
|
Soluciones de servidor Premium |
|
Server Solutions Premium (instalación principal) |
|
Inicio |
|
No compatible |
|
Starter N |
|
Storage Server Enterprise |
|
Storage Server Enterprise (instalación principal) |
|
Storage Server Express |
|
Storage Server Express (instalación básica) |
|
Storage Server Standard (instalación de evaluación) |
|
Storage Server Standard |
|
Storage Server Standard (instalación básica) |
|
Grupo de trabajo del servidor de almacenamiento (instalación de evaluación) |
|
Grupo de trabajo del servidor de almacenamiento |
|
Grupo de trabajo del servidor de almacenamiento (instalación principal) |
|
Ultimate |
|
No compatible |
|
Ultimate N |
|
Un producto desconocido |
|
Servidor web (instalación completa) |
|
Servidor web (instalación básica) |
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Esta función produce un error si uno de los parámetros de entrada no es válido.
Comentarios
Para detectar si hay instalado un rol de servidor o una característica, use el proveedor WMI de características de servidor.
Las versiones posteriores de Windows asignarán los tipos de producto que admite al conjunto de tipos de productos admitidos por cada versión anterior compatible de Windows, de nuevo a la versión 6.0.0.0. Por lo tanto, una aplicación que realiza una prueba de igualdad para cualquiera de estos valores seguirá funcionando en futuras versiones, incluso cuando se agreguen nuevos tipos de producto.
PRODUCT_*_SERVER_CORE valores no se devuelven en Windows Server 2012 y versiones posteriores. Por ejemplo, la edición de servidor base, Server Datacenter, se usa para compilar las dos opciones de instalación diferentes: "servidor completo" y "servidor principal". Con Windows Server 2012, GetProductInfo devolverá PRODUCT_DATACENTER independientemente de la opción usada durante la instalación del producto. Como se indicó anteriormente, para las instalaciones de Server Core de Windows Server 2012 y versiones posteriores, use el método Determinar si Server Core se está ejecutando.
En la tabla siguiente se indican los tipos de producto introducidos en la versión 6.1.0.0 y lo que se asignarán a si se llama a GetProductInfo con la versión 6.0.0.0 en un sistema 6.1.0.0.
| Novedades de la versión 6.1.0.0 | Valor devuelto con 6.0.0.0 |
|---|---|
| PRODUCT_PROFESSIONAL | PRODUCT_BUSINESS |
| PRODUCT_PROFESSIONAL_N | PRODUCT_BUSINESS_N |
| PRODUCT_STARTER_N | PRODUCT_STARTER |
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.
Ejemplos
Para obtener un ejemplo, consulte Obtención de la versión del sistema.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | sysinfoapi.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |