Función MsiConfigureProductA (msi.h)

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 de producto para el producto que se va a configurar.

[in] iInstallLevel

Especifica la cantidad de producto que se debe instalar al instalar el producto en su estado predeterminado. Se omite el parámetro iInstallLevel 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 siguientes valores.

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 siguientes valores.

Valor	Significado
INSTALLSTATE_LOCAL	El producto se va a instalar con todas las características instaladas localmente.
INSTALLSTATE_ABSENT	El producto se desinstala.
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 Feature Table.
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.
Error relacionado con una acción	Para obtener más información, consulte códigos de error.
error de inicialización	Error relacionado con la inicialización.

Observaciones

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.

Se omite el parámetro iInstallLevel 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 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

instalaciones de Multiple-Package