Función MsiApplyPatchA (msi.h)

Artículo
11/20/2024

Para cada producto enumerado por el paquete de revisión como apto para recibir la revisión, la función MsiApplyPatch invoca una instalación y establece la propiedad PATCH en la ruta de acceso del paquete de revisión.

Sintaxis

UINT MsiApplyPatchA(
  [in] LPCSTR      szPatchPackage,
  [in] LPCSTR      szInstallPackage,
  [in] INSTALLTYPE eInstallType,
  [in] LPCSTR      szCommandLine
);

Parámetros

[in] szPatchPackage

Cadena terminada en NULL que especifica la ruta de acceso completa al paquete de revisión.

[in] szInstallPackage

Si eInstallType se establece en INSTALLTYPE_NETWORK_IMAGE, este parámetro es una cadena terminada en null que especifica una ruta de acceso al producto que se va a aplicar revisiones. El instalador aplica la revisión a todos los productos aptos enumerados en el paquete de revisión si szInstallPackage está establecido en null y eInstallType se establece en INSTALLTYPE_DEFAULT.

Si eInstallType es INSTALLTYPE_SINGLE_INSTANCE, el instalador aplica la revisión al producto especificado por szInstallPackage. En este caso, se omiten otros productos aptos enumerados en el paquete de revisión y el parámetro szInstallPackage contiene la cadena terminada en null que representa el código de producto de la instancia que se va a aplicar revisiones. Este tipo de instalación requiere el instalador que ejecuta Windows Server 2003 o Windows XP.

[in] eInstallType

Este parámetro especifica el tipo de instalación que se va a aplicar a la revisión.

Tipo de instalación	Significado
INSTALLTYPE_NETWORK_IMAGE	Especifica una instalación administrativa. En este caso, szInstallPackage debe establecerse en una ruta de acceso del paquete. Un valor de 1 para INSTALLTYPE_NETWORK_IMAGE establece este valor para una instalación administrativa.
INSTALLTYPE_DEFAULT	Busca productos en el sistema que se van a aplicar revisiones. En este caso, szInstallPackage debe ser 0.
INSTALLTYPE_SINGLE_INSTANCE	Revise el producto especificado por szInstallPackage. szInstallPackage es el código de producto de la instancia que se va a aplicar revisiones. Este tipo de instalación requiere el instalador que ejecuta Windows Server 2003 o Windows XP con SP1. Para obtener más información, consulte instalación de varias instancias de productos y revisiones.

[in] szCommandLine

Cadena terminada en NULL que especifica la configuración de la propiedad de la línea de comandos. Vea About Properties and Setting Public Property Values on the Command Line. Consulte la sección Comentarios.

Valor devuelto

Valor	Significado
ERROR_SUCCESS	La función se completó correctamente.
ERROR_PATCH_PACKAGE_OPEN_FAILED	No se pudo abrir el paquete de revisión.
ERROR_PATCH_PACKAGE_INVALID	El paquete de revisión no es válido.
ERROR_PATCH_PACKAGE_UNSUPPORTED	No se admite el paquete de revisión.
Error relacionado con una acción	Consulte códigos de error.
error de inicialización	Error de inicialización.

Observaciones

Dado que el delimitador de lista para transformaciones, orígenes y revisiones es un punto y coma, este carácter no debe usarse para los nombres de archivo ni las rutas de acceso.

nota

Debe establecer la propiedad REINSTALAR en la línea de comandos al aplicar un de actualización pequeña o revisión de actualización secundaria. Sin esta propiedad, la revisión se registra en el sistema, pero no puede actualizar archivos. Para las revisiones que no usan un tipo de acción personalizada 51 para establecer automáticamente el DE REINSTALAR y propiedades de REINSTALLMODE, la propiedad REINSTALL debe establecerse explícitamente con el parámetro szCommandLine. Establezca el PROPIEDAD REINSTALAR para enumerar las características afectadas por la revisión o use una configuración predeterminada práctica de "REINSTALAR=ALL". El valor predeterminado de la propiedad REINSTALLMODE es "omus". A partir de la versión 3.0 de Windows Installer, el instalador configura la propiedad REINSTALAR y no es necesario establecerla en la línea de comandos.

Nota

El encabezado msi.h define MsiApplyPatch 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. Windows Installer en Windows Server 2003 o Windows XP. 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

Consulte también

códigos de error de

error de inicialización

instalaciones de Multiple-Package

no compatibles con Windows Installer 2.0 y versiones anteriores

Compartir a través de