Función MsiReinstallProductW (msi.h)

La función MsiReinstallProduct reinstala los productos.

Sintaxis

UINT MsiReinstallProductW(
  [in] LPCWSTR szProduct,
  [in] DWORD   szReinstallMode
);

Parámetros

[in] szProduct

Especifica el código de producto para que se vuelva a instalar el producto.

[in] szReinstallMode

Especifica el modo de reinstalación. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
REINSTALLMODE_FILEMISSING
Reinstalar solo si falta el archivo.
REINSTALLMODE_FILEOLDERVERSION
Reinstalar un archivo si falta o si es una versión anterior.
REINSTALLMODE_FILEEQUALVERSION
Reinstalar un archivo si falta o si la versión es igual o anterior.
REINSTALLMODE_FILEEXACT
Vuelva a instalar si falta el archivo o es una versión diferente.
REINSTALLMODE_FILEVERIFY
Compruebe los valores de suma de comprobación y vuelva a instalar el archivo si faltan o están dañados. Esta marca solo repara los archivos que tienen msidbFileAttributesChecksum en la columna Atributos de la tabla File.
REINSTALLMODE_FILEREPLACE
Forzar la reinstalación de todos los archivos, independientemente de la suma de comprobación o la versión.
REINSTALLMODE_USERDATA
Vuelva a escribir todas las entradas del Registro necesarias de la tabla del Registro que van al HKEY_CURRENT_USER

o HKEY_USERS

.
REINSTALLMODE_MACHINEDATA
Volver a escribir todas las entradas del Registro necesarias de la tabla Registry que van al subárbol del Registro HKEY_LOCAL_MACHINE

o HKEY_CLASSES_ROOT

. Vuelva a escribir toda la información de la tabla de clases, la tabla verb, la tabla PublishComponent, la tabla ProgID, la tabla MIMET, la tabla icon, la tabla de extensiones y la tabla AppID , independientemente de la asignación de equipo o usuario. Reinstale todos los componentes calificados.

Al reinstalar una aplicación, esta opción ejecuta las acciones RegisterTypeLibraries e InstallODBC .

REINSTALLMODE_SHORTCUT
Reinstalar todos los accesos directos y volver a almacenar en caché todos los iconos, sobrescribiendo los accesos directos e iconos existentes.
REINSTALLMODE_PACKAGE
Se usa para ejecutar desde el paquete de origen y volver a almacenar en caché el paquete local. No use para la primera instalación de una aplicación o característica.

Valor devuelto

Código devuelto Descripción
ERROR_INSTALL_FAILURE
Error de instalación.
ERROR_INVALID_PARAMETER
Se pasó un parámetro no válido a la función.
ERROR_INSTALL_SERVICE_FAILURE
No se pudo acceder al servicio de instalación.
ERROR_INSTALL_SUSPEND
La instalación se suspendió y está incompleta.
ERROR_INSTALL_USEREXIT
El usuario canceló la instalación.
ERROR_SUCCESS
Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_UNKNOWN_PRODUCT
El código de producto no identifica un producto conocido.
 

Para obtener más información, vea Mensajes de error mostrados.

Comentarios

Nota:

El encabezado msi.h define MsiReinstallProduct 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

   
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

Funciones de instalación y configuración

Instalaciones de varios paquetes

REINSTALLMODE (propiedad)