Instmsi.exe
Instmsi.exe est le package redistribuable pour l'installation de Windows Installer 2.0, et les versions antérieures de Windows Installer. Voir Redistribuables de Windows Installer pour les redistribuables de Windows Installer 3.0 et des versions ultérieures.
Pour plus d'informations sur la version de Windows Installer livrée avec votre système d'exploitation, voir Versions publiées de Windows Installer.
Certains produits redistribuables ne doivent pas être exécutés sur certaines versions du système d'exploitation. Le tableau suivant décrit les Instmsi compatibles avec chaque système d'exploitation.
| Si Instmsi.exe installe cette version de Windows Installer | Instmsi.exe peut être exécuté sur ces systèmes d'exploitation | Instmsi.exe ne doit pas être exécuté sur ces systèmes d'exploitation |
|---|---|---|
| Windows Installer version 1.0 | Windows 95, Windows 98, Windows NT 4.0+SP3 | Windows Me, Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer version 1.1 | Windows 95, Windows 98, Windows NT 4.0+SP3 | Windows Me, Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer version 1.2 | Windows 95, Windows 98, Windows Me, Windows NT 4.0+SP3 | Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer version 2.0 | Windows 95, Windows 98, Windows Me, Windows NT 4.0+SP6, Windows 2000 | Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
Par exemple, une application qui redistribue Windows Installer version 1.1 doit vérifier que le système d'exploitation est Windows NT 4.0 SP3 ou Windows 98/95 avant d'exécuter le package redistribuable. Les applications utilisant le package redistribuable doivent également s'assurer que la version ANSI de Windows Installer est installée sur Windows 98/95, et que la version Unicode est installée sur Windows NT ou Windows 2000. Notez que certaines applications renomment la version Unicode en InstMsiW.
Syntaxe
options instmsi
Options de la ligne de commande
Les options de la ligne de commande sont insensibles à la casse.
| Option | Description |
|---|---|
| /q | Pour une utilisation par les applications qui redistribuent Windows Installer dans le cadre d’une application d’amorçage. Aucune interface utilisateur n'est présentée à l'utilisateur. L’application d’amorçage doit vérifier le code de retour pour déterminer si un redémarrage est nécessaire en vue de terminer l’installation de Windows Installer. |
| /t | Utilisées uniquement à des fins de débogage. |
| /c : "msiinst /delayreboot" | L'option de redémarrage différé. Empêche Instmsi de demander à l'utilisateur de redémarrer, même s'il a dû remplacer des fichiers utilisés pendant l'installation. Si Instmsi est invoqué avec cette option, il renvoie ERROR_SUCCESS_REBOOT_REQUIRED s'il a dû remplacer des fichiers utilisés. S’il n’a pas besoin de remplacer les fichiers en cours d’utilisation, il renvoie ERROR_SUCCESS. Disponible avec Instmsi pour Windows Installer 2.0 ou ultérieur. Pour plus d’informations sur les redémarrages retardés, consultez la section des remarques. |
| /c : "msiinst /delayrebootq" | La version silencieuse de l'option de redémarrage différé. Elle ne présente aucune interface utilisateur à l'utilisateur. Sinon, le comportement est identique à celui de l'option précédente. Disponible avec Instmsi pour Windows Installer 2.0 ou ultérieur. Pour plus d’informations sur les redémarrages retardés, consultez la section des remarques. |
| /? | Affiche de l’aide. |
Notes
Les applications de démarrage qui utilisent Instmsi.exe pour installer le programme d'installation Windows avec une autre application peuvent nécessiter un redémarrage supplémentaire du système. Il s'agit potentiellement d'un redémarrage supplémentaire qui s'ajoute à tous les redémarrages nécessaires à l'installation de l'application.
L'option de redémarrage différé n'est recommandée qu'aux développeurs d'installations qui souhaitent éliminer le redémarrage supplémentaire causé par l'utilisation d'Instmsi.exe avec une application d'installation qui installe des fichiers en cours d'utilisation.
Les développeurs doivent effectuer les opérations suivantes dans leur application d’installation pour utiliser l’option de redémarrage différé. Cette option n'est pas disponible avec les versions d'Instmsi.exe qui installent des versions de Window Installer antérieures à la version 2.0 :
Pour utiliser l'option de redémarrage différé
Appelez Instmsi.exe avec l'une des options de ligne de commande de redémarrage différé.
Considérez le retour de ERROR_SUCCESS ou de ERROR_SUCCESS_REBOOT_REQUIRED comme un succès.
Obtenez le chemin d'accès au dossier contenant les binaires de Windows Installer nouvellement installés à partir de la valeur InstallerLocation sous :
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Installer
Cette valeur est de type REG_SZ.
Définissez le répertoire actuel sur le chemin obtenu à l'étape 3.
Appelez Msiexec sur le package d’application et exécutez d’autres codes d’installation propres à l’application. Si l'application d'installation utilise MsiInstallProduct, elle doit charger MSI.DLL à partir de l'emplacement obtenu à l'étape 3.
Remarque
Les applications qui appellent LoadLibrary sur la nouvelle MSI.DLL à l'emplacement obtenu à l'étape 3 doivent s'assurer qu'une ancienne version de MSI.DLL n'a pas déjà été chargée dans le processus. Si une ancienne version de MSI.DLL a été chargée dans le processus, elle doit être déchargée de l'espace d'adressage du processus avant l'appel de LoadLibrary pour le nouveau MSI.DLL.
Si l'étape (5) ne nécessite pas de redémarrage et si Instmsi.exe a renvoyé ERROR_SUCCESS_REBOOT_REQUIRED à l'étape (1), demandez à l'utilisateur de redémarrer pour terminer l'installation des binaires de Windows Installer sur le système. Toutefois, si un redémarrage se produit à l'étape (5), aucune étape supplémentaire n'est nécessaire.
Instmsi.exe est disponible dans les composants du SDK Windows pour les développeurs de Windows Installer.
Rubriques connexes