Función MsiApplyMultiplePatchesA (msi.h)

Artículo
11/20/2024

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 ProductCode GUID del producto que se va a revisar. 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 esNULL, las revisiones solo se aplican al producto especificado.

[in, optional] szPropertiesList

Cadena terminada en NULL que especifica la configuración de propiedades de la 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 NULL. Una cadena vacía es un parámetro no válido. Todas las propiedades se comparten en todos los productos de destino. Para obtener más información, consulte
Acerca de las propiedades y establecer 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 contrarias.
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 finalizó esta llamada a MsiApplyMultiplePatches. Es posible que todos los productos de destino no se hayan revisado.
ERROR_SUCCESS_REBOOT_REQUIRED	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.
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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	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.
de la plataforma de destino de	Windows
encabezado de	msi.h
biblioteca de	Msi.lib
DLL de	Msi.dll