Función MsiApplyPatchA (msi.h)

Artículo
02/29/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 está 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 revisar. 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 al 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 para 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 a la revisión. 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 Acerca de las propiedades y establecer valores de propiedad pública en la línea de comandos. Consulte la sección Comentarios.

Valor devuelto

Valor	Significado
ERROR_SUCCESS	Si se devuelve este valor, significa que 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.
Un 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, no se debe usar este carácter para los nombres de archivo ni las rutas de acceso.

Nota

Debe establecer la propiedad REINSTALL en la línea de comandos al aplicar una pequeña actualización o una revisión de actualización secundaria . Sin esta propiedad, la revisión se registra en el sistema, pero no puede actualizar los archivos. Para las revisiones que no usan un tipo de acción personalizada 51 para establecer automáticamente las propiedades REINSTALL y REINSTALLMODE, la propiedad REINSTALL debe establecerse explícitamente con el parámetro szCommandLine. Establezca la propiedad REINSTALL para enumerar las características afectadas por la revisión, o use una configuración predeterminada práctica con "REINSTALL=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 REINSTALL 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
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. Windows Installer en Windows Server 2003 o Windows XP. Consulte 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

Códigos de error

Error de inicialización

Instalaciones de varios paquetes

No se admite en Windows Installer 2.0 ni en versiones anteriores