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).

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.

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

Vea también

Funciones de información del sistema