MsiReinstallFeatureA, fonction (msi.h)

La fonction MsiReinstallFeature réinstalle les fonctionnalités.

Syntaxe

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

Paramètres

[in] szProduct

Spécifie le code de produit du produit qui contient la fonctionnalité à réinstaller.

[in] szFeature

Spécifie la fonctionnalité à réinstaller. La fonctionnalité parente ou enfant de la fonctionnalité spécifiée n’est pas réinstallée. Pour réinstaller la fonctionnalité parent ou enfant, vous devez appeler la fonction MsiReinstallFeature pour chacune d’elles séparément ou utiliser la fonction MsiReinstallProduct .

[in] dwReinstallMode

Spécifie ce qu’il faut installer. Ce paramètre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
REINSTALLMODE_FILEMISSING
Réinstallez uniquement si le fichier est manquant.
REINSTALLMODE_FILEOLDERVERSION
Réinstallez si le fichier est manquant ou s’il s’agit d’une version antérieure.
REINSTALLMODE_FILEEQUALVERSION
Réinstallez si le fichier est manquant, ou s’il s’agit d’une version égale ou antérieure.
REINSTALLMODE_FILEEXACT
Réinstallez si le fichier est manquant ou s’il s’agit d’une version différente.
REINSTALLMODE_FILEVERIFY
Vérifiez les valeurs de somme de contrôle et réinstallez le fichier s’ils sont manquants ou endommagés. Cet indicateur répare uniquement les fichiers qui ont msidbFileAttributesChecksum dans la colonne Attributes de la table File.
REINSTALLMODE_FILEREPLACE
Forcer la réinstallation de tous les fichiers, quelle que soit la somme de contrôle ou la version.
REINSTALLMODE_USERDATA
Réécrire toutes les entrées de Registre requises à partir de la table de Registre qui vont à l’HKEY_CURRENT_USER

ou HKEY_USERS

hive du registre.
REINSTALLMODE_MACHINEDATA
Réécrire toutes les entrées de Registre requises à partir de la table de Registre qui vont à l’HKEY_LOCAL_MACHINE

ou HKEY_CLASSES_ROOT

hive du registre. Réécrire toutes les informations de la table de classes, de la table de verbes, de la table PublishComponent, de la table ProgID, de la table MIME, de la table d’icônes, de la table d’extension et de la table AppID , quelle que soit l’affectation de l’ordinateur ou de l’utilisateur. Réinstallez tous les composants qualifiés.

Lors de la réinstallation d’une application, cette option exécute les actions RegisterTypeLibraries et InstallODBC .

REINSTALLMODE_SHORTCUT
Réinstallez tous les raccourcis et remettez en cache toutes les icônes qui remplacent tous les raccourcis et icônes existants.
REINSTALLMODE_PACKAGE
Permet d’exécuter à partir du package source et de mettre à nouveau en cache le package local. N’utilisez pas pour la première installation d’une application ou d’une fonctionnalité.

Valeur retournée

Code de retour Description
ERROR_INSTALL_FAILURE
L'installation a échoué.
ERROR_INVALID_PARAMETER
Un paramètre non valide a été passé à la fonction.
ERROR_INSTALL_SERVICE_FAILURE
Impossible d’accéder au service d’installation.
ERROR_INSTALL_SUSPEND
L’installation a été suspendue et est incomplète.
ERROR_INSTALL_USEREXIT
L’utilisateur a annulé l’installation.
ERROR_SUCCESS
La fonction s’est terminée avec succès.
ERROR_UNKNOWN_FEATURE
L’ID de fonctionnalité n’identifie pas une fonctionnalité connue.
ERROR_UNKNOWN_PRODUCT
Le code de produit n’identifie pas un produit connu.
 

Pour plus d’informations, consultez Messages d’erreur affichés.

Remarques

Notes

L’en-tête msi.h définit MsiReinstallFeature comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

   
Client minimal pris en charge Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le Service Pack Windows minimal requis par une version de Windows Installer.
Plateforme cible Windows
En-tête msi.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions d’installation et de configuration

Installations à plusieurs packages

REINSTALLMODE, propriété