Operationen des Bootstrapperbeispiels für "Setup.exe"
Aktualisiert: November 2007
Für die Verwendung des Bootstrapperbeispiels für Setup.exe sind keine Kenntnisse darüber erforderlich, wie Setup.exe die Ausführung der entsprechenden Operationen implementiert. Ausführliche Informationen darüber, wie Setup.exe bestimmte Operationen ausführt, stehen Entwicklern zur Verfügung, die ein benutzerdefiniertes Setupprogramm zur Installation von .NET Framework mit einer Anwendung erstellen möchten.
Das Bootstrapperbeispiel für Setup.exe ist für die automatische Ausführung der folgenden Operationen verantwortlich:
Erkennen einer .NET Framework-Installation
Starten einer automatischen Installation von "Dotnetfx.exe"
Verarbeiten allgemeiner Fehlercodes während der Installation
Aufrufen von MSI-Setup für eine Anwendung und Unterdrücken des Neustarts bis zur Installation der Anwendung
Erkennen einer .NET Framework-Installation
Das Bootstrapperbeispiel für Setup.exe veranschaulicht Code für das Umschließen eines Setupprogramms, mit dem überprüft wird, ob .NET Framework installiert ist. Der Code sucht in folgendem Registrierungsschlüssel nach einer bestimmten Versionsnummer von .NET Framework:
HKLM\SOFTWARE\Microsoft\.NETFramework\policy\v1.0
Die zu suchende Versionsnummer ist in Dotnetfx.exe enthalten. Der Code vergleicht die Buildnummer im Registrierungsschlüssel mit der Buildnummer von .NET Framework, das von der Anwendung gehostet wird. Ist an dieser Position keine übereinstimmende Buildnummer im Registrierungsschlüssel vorhanden, installiert Setup.exe die von der Anwendung gehostete Version von .NET Framework.
Wenn Setup.exe eine Buildnummer und eine Sprachversion von .NET Framework ermitteln soll, müssen Sie den Kulturnamen der zu suchenden Sprache in der Datei Settings.ini angeben. Wenn Sie keinen Kulturnamen angeben, sucht Setup.exe standardmäßig nach der englischen Sprachversion. Anweisungen finden Sie im Verwenden des Bootstrapperbeispiels für "Setup.exe" mit einer Anwendung-Thema zum Angeben von Kulturnamen.
Starten einer automatischen Installation von "Dotnetfx.exe"
Setup.exe verwendet den folgenden Befehl zum Starten einer automatischen Installation von Dotnetfx.exe.
dotnetfx.exe /q:a /c:"install /l /q"
Bei einer automatischen Installation wird die Anzeige aller Benutzeroberflächen und Fehlermeldungen unterdrückt, die von Dotnetfx.exe und Install.exe (in Dotnetfx.exe enthalten) zurückgegeben werden. Die Angabe der Optionen /q:a und /q führen zu einer für alle Benutzer standardisierten Installation. Bei Angabe der Option /l wird die Setupprotokolldatei Netfx.log im Verzeichnis %temp% erstellt, in der sämtliche Fehlermeldungen protokolliert werden.
Verarbeiten allgemeiner Fehlercodes während der Installation
In der folgenden Tabelle werden allgemein vorkommende Fehler aufgeführt, die vom Bootstrapperbeispiel für Setup.exe verarbeitet werden.
Fehler |
Standardtext |
|---|---|
3010 |
Der Computer muss neu gestartet werden. Soll der Computer jetzt neu gestartet werden? Es ist ein Neustart des Computers erforderlich. |
8192 |
Der Computer muss neu gestartet werden. Soll der Computer jetzt neu gestartet werden? Ein Neustart des Computers ist nach der Installation von Windows Installer erforderlich. |
4101 |
Setup wird bereits ausgeführt. Wenn eine weitere Instanz von Setup ausgeführt wird, kann diese fortgesetzt werden, und eine weitere Ausführung der aktuellen Installation ist nicht möglich. |
4097 |
Sie verfügen nicht über die erforderlichen Berechtigungen, um diese Anwendung zu installieren. Wenden Sie sich an den Administrator. Für die Installation oder Deinstallation unter Windows NT sind Administratorrechte erforderlich. |
1633 |
Dieser Computer ist zum Ausführen dieser Anwendung nicht richtig konfiguriert. Wenden Sie sich an den Support. Ungültige Plattform. |
Alle anderen Fehler |
In Setup sind Fehler aufgetreten. Die Installation kann nicht fortgesetzt werden. Während des Setups ist ein schwerwiegender Fehler aufgetreten. Die Installation von Dotnetfx.exe kann nicht fortgesetzt werden. |
Aufrufen von MSI-Setup für eine Anwendung und Unterdrücken des Neustarts bis zur Installation der Anwendung
Der folgende Befehl ruft das MSI-Setup für die Hostanwendung myapp.msi auf. Mit der Option REBOOT=ReallySuppress wird der Neustart eines Computers bis zur vollständigen Installation von myapp unterdrückt.
msiexec /i myapp.msi REBOOT=ReallySuppress
Beachten Sie, dass das Bootstrapperbeispiel für Setup.exe nicht zwangsläufig nach Fehlercodes sucht, die von der Hostanwendung myapp generiert werden, da es sich nicht um eine automatische Installation handelt und dem Benutzer alle Fehler über die Oberfläche von Windows Installer angezeigt werden.
Siehe auch
Konzepte
Verwenden des Bootstrapperbeispiels für "Setup.exe" mit einer Anwendung
Bereitstellungsszenarien für "Dotnetfx.exe"
Mindestkonfigurationsanforderungen für Dotnetfx.exe