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 |
|---|---|
|
El producto no se conoce actualmente. |
|
Se pasa un argumento no válido a la función . |
|
La información de configuración del producto no es válida. |
|
Error en la función. |
|
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