Opérations de l'exemple de programme d'amorçage Setup.exe
Vous n'avez pas besoin de connaître la façon dont Setup.exe implémente les opérations qu'il accomplit pour utiliser l'exemple de programme d'amorçage Setup.exe. Des détails sur la façon dont Setup.exe exécute certaines opérations spécifiques sont fournis à l'intention des développeurs qui souhaitent créer un programme d'installation personnalisé installant le .NET Framework avec une application.
L'exemple de programme d'amorçage Setup.exe a la charge d'exécuter automatiquement les opérations suivantes.
Détection de l'installation du .NET Framework
Lancement d'une installation en mode silencieux de Dotnetfx.exe
Traitement des codes d'erreurs courants durant l'installation
Appel du programme d'installation MSI pour une application et suppression du redémarrage jusqu'à installation de l'application
Détection de l'installation du .NET Framework
L'exemple de programme d'amorçage Setup.exe illustre le code qui est utilisé pour encapsuler un programme d'installation qui vérifiera si le .NET Framework est installé. Le code recherche un numéro de version spécifié du .NET Framework dans la clé de Registre suivante.
HKLM\SOFTWARE\Microsoft\.NETFramework\policy\v1.0
Le numéro de version à vérifier est obtenu de Dotnetfx.exe. Le code effectue une comparaison entre le numéro de build de la clé de Registre et le numéro de build du .NET Framework hébergé par l'application. S'il n'existe pas de numéro de build correspondant dans la clé de Registre, à cet emplacement, Setup.exe installe la version du .NET Framework qui est hébergée par l'application.
Notez que si vous voulez que Setup.exe recherche un numéro de build et une version linguistique du .NET Framework, vous devez spécifier le nom de culture de la langue à rechercher dans le fichier Settings.ini. Si vous ne spécifiez pas de nom de culture, Setup.exe recherche la version linguistique anglaise par défaut. Consultez la rubrique Utilisation de l'exemple de programme d'amorçage Setup.exe avec une application pour obtenir des instructions de spécification du nom de culture.
Lancement d'une installation en mode silencieux de Dotnetfx.exe
Setup.exe utilise la commande suivante pour lancer une installation en mode silencieux de Dotnetfx.exe.
dotnetfx.exe /q:a /c:"install /l /q"
Une installation en mode silencieux supprime l'affichage de toutes les interfaces utilisateur et les messages d'erreur retournés par Dotnetfx.exe et par Install.exe, lequel est contenu dans Dotnetfx.exe. La spécification des options /q:a et /q pour une installation en mode silencieux permet à tous les utilisateurs de bénéficier d'un processus d'installation standard. La spécification de l'option /l crée un fichier journal d'installation, Netfx.log, dans le répertoire %temp% où sont consignées les erreurs.
Traitement des codes d'erreurs courants durant l'installation
Le tableau suivant répertorie les erreurs courantes qui sont traitées par l'exemple de programme d'amorçage Setup.exe.
| Erreur | Texte par défaut |
|---|---|
3010 |
Le programme d'installation requiert un redémarrage. Voulez-vous redémarrer maintenant ? Le redémarrage est requis. |
8192 |
Le programme d'installation requiert un redémarrage. Voulez-vous redémarrer maintenant ? Un redémarrage de l'ordinateur est requis suite à l'installation de Windows Installer. |
4101 |
Une autre instance du programme d'installation est déjà en cours d'exécution. Si une autre instance du programme d'installation est en cours d'exécution, elle est autorisée à se poursuivre et l'installation actuelle est interrompue. |
4097 |
Vous n'avez pas les autorisations requises pour installer cette application. Contactez votre administrateur. Sous Windows NT, vous devez avoir les privilèges d'administrateur pour procéder à une installation ou à une désinstallation. |
1633 |
Votre ordinateur n'est pas configuré correctement pour exécuter cette application. Contactez le Support technique. Plate-forme non valide. |
Toutes les autres erreurs |
Le programme d'installation a rencontré des erreurs. L'installation ne peut pas continuer. Une erreur irrécupérable s'est produite pendant l'installation. L'installation de Dotnetfx.exe ne peut pas se poursuivre. |
Appel d'un programme d'installation MSI pour une application et suppression du redémarrage jusqu'à installation de l'application
La commande suivante appelle le programme d'installation MSI pour l'application hôte myapp.msi. L'option REBOOT=ReallySuppress supprime le redémarrage de l'ordinateur jusqu'à installation complète de myapp.
msiexec /i myapp.msi REBOOT=ReallySuppress
Notez que l'exemple de programme d'amorçage Setup.exe n'a pas besoin de rechercher les codes d'erreur générés par l'application hôte, myapp, parce qu'il ne s'agit pas d'une installation en mode silencieux et que toutes les erreurs sont affichées dans l'interface utilisateur de Windows Installer.
Voir aussi
Concepts
Création d'un unique projet d'installation pour installer une application .NET Framework et Dotnetfx.exe
Utilisation de l'exemple de programme d'amorçage Setup.exe avec une application
Scénarios de déploiement de Dotnetfx.exe
Configuration minimale requise