MsiReinstallProductA, fonction (msi.h)

  • Article

La fonction MsiReinstallProduct réinstalle les produits.

Syntaxe

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

Paramètres

[in] szProduct

Spécifie le code de produit pour le produit à réinstaller.

[in] szReinstallMode

Spécifie le mode de réinstallation. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur Signification
REINSTALLMODE_FILEMISSING
 Réinstaller uniquement si le fichier est manquant.
REINSTALLMODE_FILEOLDERVERSION
 Réinstaller si le fichier est manquant ou s’il s’agit d’une version antérieure.
REINSTALLMODE_FILEEQUALVERSION
 Réinstaller 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 autre version.
REINSTALLMODE_FILEVERIFY
 Vérifiez les valeurs de somme de contrôle et réinstallez le fichier si elles sont manquantes ou endommagées. Cet indicateur répare uniquement les fichiers qui ont msidbFileAttributesChecksum dans la colonne Attributs 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 du Registre qui vont à l’HKEY_CURRENT_USER

ou HKEY_USERS

registre.
REINSTALLMODE_MACHINEDATA
 Réécrire toutes les entrées de Registre requises à partir de la table Registry qui vont à la ruche HKEY_LOCAL_MACHINE

ou HKEY_CLASSES_ROOT

registre. Réécrire toutes les informations de class Table, Verb Table, PublishComponent Table, ProgID Table, MIMET Table, Icon Table, Extension Table et AppID Table , indépendamment de 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 en remplaçant les raccourcis et icônes existants.
REINSTALLMODE_PACKAGE
 Utilisez pour exécuter à partir du package source et remettez 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é transmis à la fonction.
ERROR_INSTALL_SERVICE_FAILURE
 Impossible d’accéder au service d’installation.
ERROR_INSTALL_SUSPEND
 L’installation a été interrompue 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_PRODUCT
 Le code de produit n’identifie pas un produit connu.
 

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

Notes

Notes

L’en-tête msi.h définit MsiReinstallProduct comme un 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. Le mélange 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.

Spécifications

   
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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible Windows
En-tête msi.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions d’installation et de configuration

Installations de plusieurs packages

REINSTALLMODE, propriété