Compartir a través de


Función MsiApplyPatchA (msi.h)

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