Función MsiConfigureProductExA (msi.h)

  • Artículo

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 del producto que se va a configurar.

[in] iInstallLevel

Especifica cuánto debe instalarse el producto 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 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.

[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. Para más información, consulte Sobre 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 ha realizado 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 línea de comandos pasada como szCommandLine puede contener cualquiera de las propiedades de las opciones de instalación de características. En este caso, el valor de eInstallState pasado debe ser INSTALLSTATE_DEFAULT.

El parámetro iInstallLevel se omite 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, MsiSetExternalUI o 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 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. Consulte Requisitos de Windows Installer en tiempo de ejecución 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

Mensajes de error mostrados

Códigos de error

Error de inicialización

Funciones de instalación y configuración

Instalaciones de varios paquetes