Función MsiReinstallFeatureA (msi.h)

  • Artículo

La función MsiReinstallFeature vuelve a instalar las características.

Sintaxis

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

Parámetros

[in] szProduct

Especifica el código de producto del producto que contiene la característica que se va a reinstalar.

[in] szFeature

Especifica la característica que se va a reinstalar. La característica primaria o la característica secundaria de la característica especificada no se vuelve a instalar. Para volver a instalar la característica primaria o secundaria, debe llamar a la función MsiReinstallFeature para cada una de ellas por separado o usar la función MsiReinstallProduct .

[in] dwReinstallMode

Especifica lo que se va a instalar. 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
 Comprobar los valores de suma de comprobación y reinstalar 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

. Volver a escribir toda la información de la tabla Class, la tabla Verb, la tabla PublishComponent, la tabla ProgID, la tabla MIME, la tabla Icon, la tabla Extension 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_FEATURE
 El id. de característica no identifica una característica conocida.
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 MsiReinstallFeature 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)