MsiReinstallProductA, fonction (msi.h)

Article
11/20/2024

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 que le produit soit réinstallé.

[in] szReinstallMode

Spécifie le mode de réinstallation. 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 Attributs de la table Fichier.
REINSTALLMODE_FILEREPLACE	Forcez 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 au HKEY_CURRENT_USER ou HKEY_USERS ruche du registre.
REINSTALLMODE_MACHINEDATA	Réécrire toutes les entrées de Registre requises à partir de la table de Registre qui vont au HKEY_LOCAL_MACHINE ou HKEY_CLASSES_ROOT ruche du registre. Réécrire toutes les informations dutable de classes , table détaillée, PublishComponent Table, Table ProgID, Table MIMET, Icon Table, Table d’extensionet Table AppID quel que soit l’ordinateur ou l’affectation 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 les raccourcis et icônes existants.
REINSTALLMODE_PACKAGE	Permet d’exécuter à partir du package source et de re-mettre en cache le package local. N’utilisez pas la première installation d’une application ou d’une fonctionnalité.

Valeur de retour

Retourner le code	Description
ERROR_INSTALL_FAILURE	Échec de l’installation.
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 correctement.
ERROR_UNKNOWN_PRODUCT	Le code du produit n’identifie pas un produit connu.

Pour plus d’informations, consultez Afficher les messages d’erreur.

Remarques

Note

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

Exigences

Exigence	Valeur
client minimum 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
d’en-tête	msi.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

fonctions d’installation et de configuration

plusieurs installations de package

la propriété REINSTALLMODE

Partager via