Desinstalación de revisiones

A partir de Windows Installer 3.0, es posible desinstalar algunas revisiones de las aplicaciones. La revisión debe ser una revisión desinstalable. Cuando se usa una versión de Windows Installer anterior a la versión 3.0, la eliminación de revisiones requiere desinstalar el producto de revisión y volver a instalar el producto sin aplicar la revisión.

Windows Installer 2.0: no compatible. Las revisiones aplicadas con una versión de Windows Installer anterior a Windows Installer 3.0 no se pueden desinstalar.

Al invocar una desinstalación de una revisión mediante cualquiera de los métodos siguientes, el instalador intenta quitar la revisión del primer producto visible para la aplicación o el usuario que solicita la desinstalación. El instalador busca productos con revisiones en el siguiente orden: por usuario administrado, por usuario no administrado, por máquina.

Desinstalación de una revisión mediante MSIPATCHREMOVE en una línea de comandos

Puede desinstalar revisiones de un comando mediante msiexec.exe y las opciones de la línea de comandos. En la siguiente línea de comandos de ejemplo se quita una revisión desinstalable, example.msp, de una aplicación, example.msi, mediante la propiedad MSIPATCHREMOVE y la opción de línea de comandos /i. Al usar /i, se puede identificar a la aplicación con revisiones mediante la ruta de acceso al paquete de la aplicación (archivo .msi) o el código de producto de la aplicación. En este ejemplo, el paquete de instalación de la aplicación se encuentra en "\\server\share\products\example\example.msi" y la propiedad ProductCode de la aplicación es "{0C9840E7-7F0B-C648-10F0-4641926FE463}". El paquete de revisión se encuentra en "\\server\share\products\example\patch\example.msp" y el GUID del código de revisión es "{EB8C947C-78B2-85A0-644D-86CEEF8E07C0}".

Msiexec /I {0C9840E7-7F0B-C648-10F0-4641926FE463} MSIPATCHREMOVE={EB8C947C-78B2-85A0-644D-86CEEF8E07C0} /qb

Desinstalación de una revisión mediante las opciones de línea de comandos estándar

A partir de la versión 3.0 de Windows Installer, puedes usar las opciones de línea de comandos estándar que usan las Actualizaciones del sistema operativo Microsoft Windows (update.exe) para desinstalar las revisiones de Windows Installer desde una línea de comandos.

La siguiente línea de comandos es el equivalente de línea de comandos estándar de la línea de comandos de Windows Installer que se usa para desinstalar una revisión mediante la propiedad MSIPATCHREMOVE. La opción /uninstall que se usa con la opción /package indica la desinstalación de una revisión. La ruta de acceso completa a la revisión o el GUID del código de revisión pueden hacer referencia a la revisión.

Msiexec /package {0C9840E7-7F0B-C648-10F0-4641926FE463} /uninstall {EB8C947C-78B2-85A0-644D-86CEEF8E07C0} /passive

Nota

La opción estándar /passive no es un equivalente exacto de la opción /qb de Windows Installer.

 

Desinstalación de una revisión mediante el método RemovePatches

Puede desinstalar las revisiones del script mediante la interfaz de automatización de Windows Installer. En el ejemplo de scripting siguiente se quita una revisión desinstalable, example.msp, de una aplicación, example.msi, mediante el método RemovePatches del objeto Installer. Cada revisión que se desinstala se puede representar mediante la ruta de acceso completa al paquete de revisión o el GUID del código de revisión. En este ejemplo, el paquete de instalación de la aplicación se encuentra en "\\server\share\products\example\example.msi" y la propiedad ProductCode de la aplicación es "{0C9840E7-7F0B-C648-10F0-4641926FE463}". El paquete de revisión se encuentra en "\\server\share\products\example\patch\example.msp" y el GUID del código de revisión es "{EB8C947C-78B2-85A0-644D-86CEEF8E07C0}".

const msiInstallTypeSingleInstance = 2
const PatchList = "{EB8C947C-78B2-85A0-644D-86CEEF8E07C0}"
const Product = "{0C9840E7-7F0B-C648-10F0-4641926FE463}"

Dim installer
Set installer = CreateObject("WindowsInstaller.Installer")

installer.RemovePatches(PatchList, Product, msiInstallTypeSingleInstance, "")

Desinstalación de una revisión mediante Agregar o quitar programas

Con Windows XP, puede desinstalar revisiones mediante Agregar o quitar programas.

Desinstalación de una revisión mediante la función MsiRemovePatches

Las aplicaciones pueden desinstalar revisiones de otras aplicaciones mediante las funciones de Windows Installer. En el ejemplo de código siguiente se quita una revisión desinstalable, example.msp, de una aplicación, example.msi, mediante la función MsiRemovePatches. Se puede hacer referencia a una revisión mediante la ruta de acceso completa al paquete de revisión o al GUID del código de revisión. En este ejemplo, el paquete de instalación de la aplicación se encuentra en "\\server\share\products\example\example.msi" y la propiedad ProductCode de la aplicación es "{0C9840E7-7F0B-C648-10F0-4641926FE463}". El paquete de revisión se encuentra en "\\server\share\products\example\patch\example.msp" y el GUID del código de revisión es "{EB8C947C-78B2-85A0-644D-86CEEF8E07C0}".

    UINT uiReturn = MsiRemovePatches(
          /*szPatchList=*/TEXT("\\server\\share\\products\\example\\patches\\example.msp"),
          /*szProductCode=*/  TEXT("{0C9840E7-7F0B-C648-10F0-4641926FE463}"),
          /*eUninstallType=*/ INSTALLTYPE_SINGLE_INSTANCE,
          /*szPropertyList=*/ NULL);

Desinstalación de una revisión de todas las aplicaciones mediante la función MsiRemovePatches

Una sola revisión puede actualizar más de un producto en el equipo. Una aplicación puede usar MsiEnumProductsEx para mostrar todos los productos del equipo y determinar si se ha aplicado una revisión a una instancia determinada del producto. A continuación, la aplicación puede desinstalar la revisión mediante MsiRemovePatches. Por ejemplo, una sola revisión puede actualizar varios productos si la revisión actualiza un archivo en un componente compartido por varios productos y la revisión se distribuye para actualizar ambos productos.

En el ejemplo siguiente se muestra cómo una aplicación puede usar Windows Installer para quitar una revisión de todas las aplicaciones que están disponibles para el usuario. No quita la revisión de las aplicaciones instaladas por usuario para otro usuario.

#ifndef UNICODE
#define UNICODE
#endif //UNICODE

#ifndef _WIN32_MSI
#define _WIN32_MSI 300
#endif //_WIN32_MSI

#include <stdio.h>
#include <windows.h>
#include <msi.h>

#pragma comment(lib, "msi.lib")

const int cchGUID = 38;

///////////////////////////////////////////////////////////////////
// RemovePatchFromAllVisibleapplications:
//
// Arguments:
//    wszPatchToRemove - GUID of patch to remove
//
///////////////////////////////////////////////////////////////////
//
UINT RemovePatchFromAllVisibleapplications(LPCWSTR wszPatchToRemove)
{
    if (!wszPatchToRemove)
        return ERROR_INVALID_PARAMETER;

    UINT uiStatus = ERROR_SUCCESS;
    DWORD dwIndex = 0;
    WCHAR wszapplicationCode[cchGUID+1] = {0};

    DWORD dwapplicationSearchContext = MSIINSTALLCONTEXT_ALL;
    MSIINSTALLCONTEXT dwInstallContext = MSIINSTALLCONTEXT_NONE;

    do
    {
        // Enumerate all visible applications in all contexts for the caller.
        // NULL for szUserSid defaults to using the caller's SID
        uiStatus = MsiEnumProductsEx(/*szapplicationCode*/NULL,
         /*szUserSid*/NULL,
         dwapplicationSearchContext,
         dwIndex,
         wszapplicationCode,
         &dwInstallContext,
         /*szSid*/NULL,
         /*pcchSid*/NULL);

        if (ERROR_SUCCESS == uiStatus)
        {
            // check to see if the provided patch is
            // registered for this application instance
            UINT uiPatchStatus = MsiGetPatchInfoEx(wszPatchToRemove,
             wszapplicationCode,
             /*szUserSid*/NULL,
             dwInstallContext,
             INSTALLPROPERTY_PATCHSTATE,
             NULL,
             NULL);

            if (ERROR_SUCCESS == uiPatchStatus)
            {
                // patch is registered to this application; remove patch
                wprintf(L"Removing patch %s from application %s...\n",
                 wszPatchToRemove, wszapplicationCode);
                                
                UINT uiRemoveStatus = MsiRemovePatches(
                 wszPatchToRemove,
                 wszapplicationCode,
                 INSTALLTYPE_SINGLE_INSTANCE,
                 L"");

                if (ERROR_SUCCESS != uiRemoveStatus)
                {
                    // This halts the enumeration and fails. Alternatively
                    // you could output an error and continue the
                    // enumeration
                     return ERROR_FUNCTION_FAILED;
                }
            }
            else if (ERROR_UNKNOWN_PATCH != uiPatchStatus)
            {
                // Some other error occurred during processing. This
                // halts the enumeration and fails. Alternatively you
                // could output an error and continue the enumeration
                 return ERROR_FUNCTION_FAILED;
            }
            // else patch was not applied to this application
            // (ERROR_UNKNOWN_PATCH returned)
        }

        dwIndex++;
    }
    while (uiStatus == ERROR_SUCCESS);

    if (ERROR_NO_MORE_ITEMS != uiStatus)
        return ERROR_FUNCTION_FAILED;

    return ERROR_SUCCESS;
}

Secuenciación de revisiones

Eliminación de revisiones

Revisiones desinstalables

Acciones personalizadas de desinstalación de revisiones

MSIPATCHREMOVE

MsiEnumapplicationsEx

MsiGetPatchInfoEx

MsiRemovePatches