Función MsiRemovePatchesA (msi.h)

Artículo
03/05/2024

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