Operationen des Bootstrapperbeispiels für "Setup.exe"

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 Umfassen 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. Eine Anleitung für die Angabe eines Kulturnamens finden Sie unter Erstellen einer Settings.ini-Datei.

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

Weitergeben von .NET Framework | Erstellen eines Setup-Projekts für die gleichzeitige Installation einer .NET Framework-Anwendung und von "Dotnetfx.exe" | Verwenden des Bootstrapperbeispiels für "Setup.exe" mit einer Anwendung | Weitergabeszenarien für "Dotnetfx.exe" | Mindestkonfigurationsanforderungen