Función MsiConfigureProductA (msi.h)

  • Artículo

La función MsiConfigureProduct instala o desinstala un producto.

Sintaxis

UINT MsiConfigureProductA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState
);

Parámetros

[in] szProduct

Especifica el código del producto que se va a configurar.

[in] iInstallLevel

Especifica cuánto debe instalarse el producto al instalar el producto en su estado predeterminado. El parámetro iInstallLevel se omite y se instalan todas las características, si el parámetro eInstallState se establece en cualquier otro valor que no sea INSTALLSTATE_DEFAULT.

Este parámetro puede ser uno de los valores siguientes.

Valor Significado
INSTALLLEVEL_DEFAULT
 Se instalan las características predeterminadas creadas.
INSTALLLEVEL_MINIMUM
 Solo se instalan las características necesarias. Puede especificar un valor entre INSTALLLEVEL_MINIMUM y INSTALLLEVEL_MAXIMUM para instalar un subconjunto de características disponibles.
INSTALLLEVEL_MAXIMUM
 Todas las características están instaladas. Puede especificar un valor entre INSTALLLEVEL_MINIMUM y INSTALLLEVEL_MAXIMUM para instalar un subconjunto de características disponibles.

[in] eInstallState

Especifica el estado de instalación del producto. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
INSTALLSTATE_LOCAL
 El producto se instalará con todas las características instaladas localmente.
INSTALLSTATE_ABSENT
 El producto está desinstalado.
INSTALLSTATE_SOURCE
 El producto se va a instalar con todas las características instaladas para ejecutarse desde el origen.
INSTALLSTATE_DEFAULT
 El producto debe instalarse con todas las características instaladas en los estados predeterminados especificados en la tabla de características.
INSTALLSTATE_ADVERTISED
 El producto se anuncia.

Valor devuelto

Valor Significado
ERROR_INVALID_PARAMETER
 Se pasa un parámetro no válido a la función .
ERROR_SUCCESS
 La función se realiza correctamente.
Un error relacionado con una acción
 Para más información, consulte Códigos de error.
Error de inicialización
 Error relacionado con la inicialización.

Comentarios

La función MsiConfigureProduct muestra la interfaz de usuario (UI) mediante la configuración actual. La configuración de la interfaz de usuario se puede cambiar mediante MsiSetInternalUI, MsiSetExternalUI o MsiSetExternalUIRecord.

El parámetro iInstallLevel se omite y se instalan todas las características del producto, si el parámetro eInstallState se establece en cualquier otro valor que no sea INSTALLSTATE_DEFAULT. Para controlar la instalación de características individuales cuando el parámetro eInstallState no está establecido en INSTALLSTATE_DEFAULT, use MsiConfigureFeature.

Nota

El encabezado msi.h define MsiConfigureProduct 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
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

Instalaciones de varios paquetes