Función MsiApplyMultiplePatchesA (msi.h)
La función MsiApplyMultiplePatches aplica una o varias revisiones a los productos aptos para recibir las revisiones. La función MsiApplyMultiplePatches establece la propiedad PATCH con una lista de revisiones delimitadas por punto y coma e invoca la aplicación de revisiones de los productos de destino. Otras propiedades se pueden establecer mediante una lista de propiedades.
Sintaxis
UINT MsiApplyMultiplePatchesA(
[in] LPCSTR szPatchPackages,
[in, optional] LPCSTR szProductCode,
[in, optional] LPCSTR szPropertiesList
);
Parámetros
[in] szPatchPackages
Lista delimitada por punto y coma de las rutas de acceso a los archivos de revisión como una sola cadena. Por ejemplo: ""c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp" "
[in, optional] szProductCode
Este parámetro es el GUID productCode del producto que se va a aplicar revisiones. El usuario o la aplicación que llama a MsiApplyMultiplePatches deben tener privilegios para aplicar revisiones. Cuando este parámetro es NULL, las revisiones se aplican a todos los productos aptos. Cuando este parámetro no es NULL, las revisiones solo se aplican al producto especificado.
[in, optional] szPropertiesList
Cadena terminada en null que especifica la configuración de propiedades de línea de comandos usada durante la aplicación de revisiones de productos. Si no hay ninguna configuración de propiedad de línea de comandos, pase un puntero NULL . Una cadena vacía es un parámetro no válido. Todas las propiedades son compartidas por todos los productos de destino. Para obtener más información, vea
Acerca de propiedades y establecimiento de valores de propiedad pública en la línea de comandos.
Valor devuelto
La función MsiApplyMultiplePatches devuelve los valores siguientes.
Valor | Significado |
---|---|
|
Algunos argumentos pasados son incorrectos o contrarios. |
|
La función completada y todos los productos se revisan correctamente. ERROR_SUCCESS solo se devuelve si todos los productos aptos para las revisiones se revisan correctamente. Si no se aplica ninguna de las nuevas revisiones, MsiApplyMultiplePatches devuelve ERROR_SUCCESS y el estado del producto permanece sin cambios. |
|
El reinicio iniciado por la última transacción finalizó esta llamada a MsiApplyMultiplePatches. Es posible que todos los productos de destino no se hayan revisado. |
|
El reinicio requerido por la última transacción finalizó esta llamada a MsiApplyMultiplePatches. Es posible que todos los productos de destino no se hayan revisado. |
|
No se pudo abrir uno de los paquetes de revisión. |
|
Uno de los paquetes de revisión proporcionados no es válido. |
|
Uno de los paquetes de revisión no es compatible. |
|
Implica una posible finalización parcial o que se produjo un error en una o varias transacciones. |
Comentarios
Nota
El encabezado msi.h define MsiApplyMultiplePatches 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 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. |
Plataforma de destino | Windows |
Encabezado | msi.h |
Library | Msi.lib |
Archivo DLL | Msi.dll |
Consulte también
Instalaciones de varios paquetes
No se admite en Windows Installer 2.0 y versiones anteriores
Establecer valores de propiedad pública en la línea de comandos