Función MsiIsProductElevatedW (msi.h)

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

Una aplicación que se instala 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, consulte Publicidad de una aplicación de Per-User que se va a instalar con privilegios elevados.

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

Sintaxis

UINT MsiIsProductElevatedW(
  [in]  LPCWSTR szProduct,
  [out] BOOL    *pfElevated
);

Parámetros

[in] szProduct

El GUID de código de producto completo del producto.

Este parámetro es obligatorio y no puede ser NULL ni estar vacío.

[out] pfElevated

Puntero a un 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	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 para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino	Windows
Encabezado	msi.h
Library	Msi.lib
Archivo DLL	Msi.dll

Consulte también

Determinación del contexto de instalación

Instalación de un paquete con privilegios elevados por parte de un usuario no administrador