Compartir a través de


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

Una 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 a la revisión. 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 la propiedad de línea de comandos utilizada 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. Todos los productos de destino comparten estas propiedades. Para obtener más información, vea
Acerca de las propiedades y el establecimiento de valores de propiedad pública en la línea de comandos.

Nota La lista de propiedades no debe contener la propiedad PATCH . Si la propiedad PATCH se establece en la línea de comandos, se omite el valor y se sobrescribe con las revisiones que se aplican.
 

Valor devuelto

La función MsiApplyMultiplePatches devuelve los valores siguientes.

Valor Significado
ERROR_INVALID_PARAMETER
Algunos argumentos pasados son incorrectos o contradecían.
ERROR_SUCCESS
La función se completó y todos los productos se revisaron 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.
ERROR_SUCCESS_REBOOT_INITIATED
El reinicio iniciado por la última transacción terminó esta llamada a MsiApplyMultiplePatches. Es posible que no se hayan revisado todos los productos de destino.
ERROR_SUCCESS_REBOOT_REQUIRED
El reinicio requerido por la última transacción terminó esta llamada a MsiApplyMultiplePatches. Es posible que no se hayan revisado todos los productos de destino.
ERROR_PATCH_PACKAGE_OPEN_FAILED
No se pudo abrir uno de los paquetes de revisión.
ERROR_PATCH_PACKAGE_INVALID
Uno de los paquetes de revisión proporcionados no es válido.
ERROR_PATCH_PACKAGE_UNSUPPORTED
Uno de los paquetes de revisión no es compatible.
Cualquier error en Winerror.h
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 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

Acerca de las propiedades

Instalaciones de varios paquetes

No se admite en Windows Installer 2.0 ni en versiones anteriores

PATCH

ProductCode

Establecimiento de valores de propiedad pública en la línea de comandos