Función MsiApplyMultiplePatchesA (msi.h)

Artículo
08/24/2023

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