InstallValidate-Aktion

Die InstallValidate-Aktion überprüft, ob alle Volumes, denen Kosten zugeordnet wurden, ausreichend Speicherplatz für die Installation aufweisen. Die InstallValidate-Aktion beendet die Installation mit einem schwerwiegenden Fehler, wenn ein Volume nicht genügend Speicherplatz hat.

Die InstallValidate-Aktion benachrichtigt den Benutzer auch, wenn mindestens eine zu überschreibende Oder entfernte Datei derzeit von einem aktiven Prozess verwendet wird. Weitere Informationen finden Sie unter Systemneustarts.

Sequenzeinschränkungen

Die CostFinalize Aktion und alle Ui-Dialogfeldsequenzen, mit denen der Benutzer Auswahlzustände und/oder Verzeichnisse ändern kann, sollte vor der InstallValidate-Aktion sequenziert werden.

benutzerdefinierte Aktionen, die den Installationsstatus von Features oder Komponenten ändern, müssen vor der InstallationValidate-Aktion sequenziert werden.

ActionData-Nachrichten

Es sind keine ActionData-Nachrichten vorhanden.

Bemerkungen

In der Regel sollte eine frühere Benutzeroberflächendialogfeldsequenz dieselbe Überprüfung wie die InstallValidate-Aktion ausführen, wenn der Benutzer versucht, das Kopieren von Dateien zu initiieren. Diese Benutzeroberfläche-Dialogfeldsequenz sollte ein Nicht genügend Speicherplatz Dialogfeld darstellen, wenn die ausgewählten Volumes nicht über genügend Speicherplatz für die Installation verfügen. Die Dialogfelder der Benutzeroberfläche sollten so erstellt werden, dass der Benutzer nicht mit der Installation fortfahren kann, wenn nicht genügend Speicherplatz vorhanden ist. Bei einer stillen Installation gibt es keine Benutzeroberfläche, und die InstallValidate-Aktion beendet die Installation, wenn nicht genügend Speicherplatz vorhanden ist. Die Ursache der vorzeitigen Beendigung wird in der Protokolldatei aufgezeichnet, wenn die Protokollierung aktiviert ist.

Ein Eintrag wird einer internen FilesInUse-Tabelle hinzugefügt, wenn eine Datei überschrieben oder entfernt wird, während sie zur Ausführung oder Änderung durch einen beliebigen Prozess während der Datei geöffnet ist, Kosten. Die Tabelle "FilesInUse" enthält Spalten für den Namen und den vollständigen Pfad der Datei. Wenn die InstallValidate-Aktion ausgeführt wird, fragt das Installationsprogramm die DateiInUse-Tabelle nach Einträgen ab und bestimmt den Namen des Prozesses mithilfe der Datei. Die InstallValidate-Aktion fügt der ListBox Benutzeroberflächentabelle für jeden eindeutigen Prozess, der von dieser Abfrage identifiziert wird, einen Datensatz hinzu. Der Datensatz enthält die folgenden Werte in jeder Spalte:

Eigenschaft: FileInUseProcess

Wert: Name des Prozesses

Text: Text, der in der Beschriftung des Hauptfensters des Prozesses enthalten ist

Die InstallValidate-Aktion zeigt dann das Dialogfeld Dateien in Verwendung an. In diesem Dialogfeld werden die Prozesse angezeigt, die heruntergefahren werden müssen, um zu vermeiden, dass das System neu gestartet wird, um dateien zu ersetzen, die verwendet werden.

Die InstallValidate-Aktion fragt die Dialog- Tabelle für ein erstelltes Dialogfeld mit dem reservierten Namen FilesInUse Dialogfeld ab und zeigt sie an. Dieses Dialogfeld muss ein ListBox--Steuerelement enthalten, das an eine Eigenschaft mit dem Namen FileInUseProcess gebunden ist. In der Konvention verfügt dieses Dialogfeld über eine schaltfläche Beenden, Wiederholenoder Schaltfläche " ignorieren", dies liegt jedoch bei dem Benutzeroberflächenautor. Jede Schaltfläche sollte an ein EndDialog ControlEvent in der ControlEvent- Tabelle gebunden sein. Die InstallValidate-Aktion antwortet wie folgt auf den Wert, der vom DoAction ControlEvent zurückgegeben wird, wie von einem der folgenden EndDialog Argumenten festgelegt, die der vom Benutzer gedrückten Schaltfläche zugeordnet sind:

Wiederholen sie: Alle Werte, die der ListBox- Tabelle hinzugefügt wurden, werden gelöscht, und die gesamte Datei Kalkulation Prozedur wiederholt, wird erneut auf Dateien überprüft, die noch verwendet werden. Wenn ein oder mehrere Prozesse weiterhin als zu überschreibende oder gelöschte Dateien identifiziert werden, wiederholt sich der Prozess. andernfalls gibt InstallValidate die Steuerung an das Installationsprogramm mit dem Status msiDoActionStatusSuccess zurück.

Beenden: Die InstallValidate-Aktion gibt sofort die Steuerung an das Installationsprogramm mit dem Status msiDoActionStatusUserExit zurück. Dadurch wird die Installation beendet.

Alle anderen Rückgabewerte: Die InstallValidate-Aktion gibt sofort die Steuerung an das Installationsprogramm mit dem Status "msiDoActionStatusSuccess" zurück. Da in diesem Fall noch eine oder mehrere Dateien verwendet werden, müssen die nachfolgenden InstallFiles und/oder InstallAdminPackage Aktionen planen, dass die nicht verwendeten Dateien ersetzt oder gelöscht werden, wenn das System neu gestartet wird.

Wenn keine ListBox- Tabelle in der Datenbank vorhanden ist, wird InstallValidate ohne Fehler im Hintergrund beendet.

Das Semikolon ist das Listentrennzeichen für Transformationen, Quellen und Patches und sollte nicht in diesen Dateinamen oder Pfaden verwendet werden.

Dateien, die als schreibgeschützt gekennzeichnet sind, werden vom Installationsprogramm niemals als schreibgeschützt betrachtet.

Ein Standardmäßiges Dialogfeld Nicht genügend Speicherplatz mit Abbrechen und Schaltflächen " Wiederholen" wird dem Benutzer angezeigt, wenn die Benutzeroberflächenebene einfach ist.