Función MsiReinstallProductA (msi.h)

  • Artículo

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 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 a la 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 extensión y la tabla AppID , independientemente de la asignación de equipo o usuario. Vuelva a instalar 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 un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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)