Compartir a través de


Función MsiRemovePatchesA (msi.h)

La función MsiRemovePatches quita una o varias revisiones de un solo producto. Para quitar una revisión de varios productos, se debe llamar a MsiRemovePatches para cada producto.

Sintaxis

UINT MsiRemovePatchesA(
  [in]           LPCSTR      szPatchList,
  [in]           LPCSTR      szProductCode,
  [in]           INSTALLTYPE eUninstallType,
  [in, optional] LPCSTR      szPropertyList
);

Parámetros

[in] szPatchList

Cadena terminada en NULL que representa la lista de revisiones que se van a quitar. Cada revisión se puede especificar mediante el GUID de la revisión o la ruta de acceso completa al paquete de revisión. Las revisiones de la lista están delimitadas por punto y coma.

[in] szProductCode

Cadena terminada en null que es productCode (GUID) del producto del que se quitan las revisiones. Este parámetro no puede ser NULL.

[in] eUninstallType

Valor que indica el tipo de eliminación de revisiones que se va a realizar. Este parámetro debe ser INSTALLTYPE_SINGLE_INSTANCE.

Valor Significado
INSTALLTYPE_SINGLE_INSTANCE
La revisión se desinstala solo para el producto especificado por szProduct.

[in, optional] szPropertyList

Cadena terminada en null que especifica la configuración de la propiedad de la línea de comandos. Para obtener más información, vea
Acerca de las propiedades y el establecimiento de valores de propiedad pública en la línea de comandos. Este parámetro puede ser NULL.

Valor devuelto

La función MsiRemovePatches devuelve los valores siguientes.

Valor Significado
ERROR_INVALID_PARAMETER
Se incluyó un parámetro no válido.
ERROR_PATCH_PACKAGE_OPEN_FAILED
No se pudo abrir el paquete de revisión.
ERROR_SUCCESS
La revisión se quitó correctamente.
ERROR_UNKNOWN_PRODUCT
El producto especificado por szProductList no está instalado por máquina o por usuario para el autor de la llamada de MsiRemovePatches.
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
Esta versión del servicio Windows Installer no puede procesar el paquete de revisión.
ERROR_PATCH_REMOVAL_UNSUPPORTED
El paquete de revisión no es extraíble.
ERROR_UNKNOWN_PATCH
La revisión no se ha aplicado a este producto.
ERROR_PATCH_REMOVAL_DISALLOWED
La directiva no permite la eliminación de revisiones.

Observaciones

Consulte Desinstalación de revisiones para ver un ejemplo que muestra cómo una aplicación puede quitar una revisión de todos los productos que están disponibles para el usuario.

Nota

El encabezado msi.h define MsiRemovePatches 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. Consulte Requisitos de Windows Installer en tiempo de ejecución 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

Acerca de las propiedades

MsiApplyPatch

Instalaciones de varios paquetes

No se admite en Windows Installer 2.0 ni en versiones anteriores

ProductCode

Eliminación de revisiones

Establecimiento de valores de propiedad pública en la línea de comandos

Desinstalación de revisiones