Compartir a través de


Función MsiReinstallProductA (msi.h)

La función MsiReinstallProduct vuelve a instalar productos.

Sintaxis

UINT MsiReinstallProductA(
  [in] LPCSTR szProduct,
  [in] DWORD  szReinstallMode
);

Parámetros

[in] szProduct

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

[in] szReinstallMode

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

Valor Significado
REINSTALLMODE_FILEMISSING
Vuelva a instalar solo si falta el archivo.
REINSTALLMODE_FILEOLDERVERSION
Vuelva a instalar si falta el archivo o es una versión anterior.
REINSTALLMODE_FILEEQUALVERSION
Vuelva a instalar si falta el archivo o es una versión 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 Archivo de .
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 de que van al HKEY_CURRENT_USER

o HKEY_USERS

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

o HKEY_CLASSES_ROOT

subárbol del registro. Vuelva a escribir toda la información de tabla de clases, tabla verb, PublishComponent Table, Tabla ProgID, tabla MIMET, Tabla de iconos, Tabla de extensióny Tabla appID independientemente de la asignación de equipos o usuarios. Vuelva a instalar todos los componentes calificados de .

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

REINSTALLMODE_SHORTCUT
Reinstale todos los accesos directos y vuelva a almacenar en caché todos los iconos sobrescribir los accesos directos e iconos existentes.
REINSTALLMODE_PACKAGE
Use 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 en la 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
La función se completó correctamente.
ERROR_UNKNOWN_PRODUCT
El código del producto no identifica un producto conocido.
 

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

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido 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 Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de Windows
encabezado de msi.h
biblioteca de Msi.lib
DLL de Msi.dll

Consulte también

funciones de instalación y configuración

instalación de varios paquetes

de propiedades REINSTALLMODE