Función MsiConfigureProductExA (msi.h)

La función MsiConfigureProductEx instala o desinstala un producto. También se puede especificar una línea de comandos de producto.

Sintaxis

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

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. Los parámetros iInstallLevel se omiten y se instalan todas las características, si el parámetro eInstallState se establece en cualquier valor distinto de 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.

[in] szCommandLine

Especifica la configuración de la propiedad de la línea de comandos. Debe ser una lista del formato Property=Setting Property=Setting Property=Setting. Para obtener más información, vea Acerca de las propiedades.

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 realizó 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 línea de comandos pasada como szCommandLine puede contener cualquiera de las propiedades de opciones de instalación de características de . En este caso, el eInstallState pasado debe ser INSTALLSTATE_DEFAULT.

Se omite el parámetro iInstallLevel y todas las características del producto se instalan 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.

La función MsiConfigureProductEx muestra la interfaz de usuario mediante la configuración actual. La configuración de la interfaz de usuario se puede cambiar con MsiSetInternalUI, MsiSetExternalUIo MsiSetExternalUIRecord.

Nota

El encabezado msi.h define MsiConfigureProductEx 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. 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

mensajes de error mostrados

códigos de error de

error de inicialización

funciones de instalación y configuración

instalaciones de Multiple-Package