Función MsiApplyPatchW (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 MsiApplyPatchW(
[in] LPCWSTR szPatchPackage,
[in] LPCWSTR szInstallPackage,
[in] INSTALLTYPE eInstallType,
[in] LPCWSTR 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 para 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 al que se va a aplicar a la revisión.
Tipo de instalación | Significado |
---|---|
|
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. |
|
Busca productos en el sistema para aplicar revisiones. En este caso, szInstallPackage debe ser 0. |
|
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 |
---|---|
|
Si se devuelve este valor, significa que la función se completó correctamente. |
|
No se pudo abrir el paquete de revisión. |
|
El paquete de revisión no es válido. |
|
El paquete de revisión no es compatible. |
|
Consulte Códigos de error. |
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.
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 windows Installer versión 3.0, 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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. 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
Instalaciones de varios paquetes
No se admite en Windows Installer 2.0 ni en versiones anteriores