Función MsiIsProductElevatedA (msi.h)

La función MsiIsProductElevated devuelve si el producto se administra o no. Solo las aplicaciones que requieren privilegios elevados para la instalación y la instalación a través de anuncios se consideran administradas, lo que significa que una aplicación instalada por máquina siempre se considera administrada.

Una aplicación instalada por usuario solo se considera administrada si se anuncia mediante un proceso del sistema local que suplanta al usuario. Para obtener más información, vea Advertising a Per-User Application to be Installed with Elevated Privileges.

MsiIsProductElevated comprueba que el sistema local posee los datos del Registro de productos. La función no hace referencia a directivas de cuenta como AlwaysInstallElevated.

Sintaxis

UINT MsiIsProductElevatedA(
  [in]  LPCSTR szProduct,
  [out] BOOL   *pfElevated
);

Parámetros

[in] szProduct

Guid de código de producto completo del producto.

Este parámetro es necesario y no se puede NULL ni estar vacío.

[out] pfElevated

Puntero a una BOOL para el resultado.

Este parámetro no puede ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS y pfElevated se establece en TRUE si el producto es una aplicación administrada.

Si se produce un error en la función, el valor devuelto es uno de los códigos de error identificados en la tabla siguiente.

Código devuelto	Descripción
ERROR_UNKNOWN_PRODUCT	El producto no se conoce actualmente.
ERROR_INVALID_PARAMETER	Se pasa un argumento no válido a la función .
ERROR_BAD_CONFIGURATION	La información de configuración del producto no es válida.
ERROR_FUNCTION_FAILED	Error en la función.
ERROR_CALL_NOT_IMPLEMENTED	La función no está disponible para una plataforma específica.

Observaciones

Nota

El encabezado msi.h define MsiIsProductElevated como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP. Consulte Windows Installer Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de	Windows
encabezado de	msi.h
biblioteca de	Msi.lib
DLL de	Msi.dll

Consulte también

determinar el contexto de instalación

instalar un paquete con privilegios elevados para un que no sea administrador