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 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.
[in] eInstallState
Especifica el estado de instalación del producto. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
El producto se instalará con todas las características instaladas localmente. |
|
El producto está desinstalado. |
|
El producto se va a instalar con todas las características instaladas para ejecutarse desde el origen. |
|
El producto debe instalarse con todas las características instaladas en los estados predeterminados especificados en la tabla de características. |
|
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 |
|---|---|
|
Se pasa un parámetro no válido a la función . |
|
La función se ha realizado correctamente. |
|
Para más información, consulte Códigos de error. |
| 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 |