RemoveFiles-Aktion

  • Artikel

Die RemoveFiles-Aktion entfernt Dateien, die zuvor von der InstallFiles-Aktion installiert wurden. Jede dieser Dateien wird durch einen Link zu einem Eintrag in der Component-Tabelle abgegrenzt. Es werden nur die Dateien entfernt, deren Komponenten in den Zustand msiInstallStateAbsent oder msiInstallStateLocal aufgelöst werden, wenn die Komponente lokal installiert ist.

Sequenzeinschränkungen

Die InstallValidate-Aktion muss vor RemoveFiles aufgerufen werden. Wenn eine InstallFiles-Aktion verwendet wird, muss sie nach RemoveFiles auftreten.

ActionData-Meldungen

Feld Beschreibung der Aktionsdaten
[1] Bezeichner der entfernten Datei
[9] Bezeichner des Verzeichnisses, in dem sich die entfernte Datei befindet

 

Bemerkungen

Die RemoveFile-Tabelle kann in der Installer-Datenbank weggelassen werden, wenn keine sonstigen Dateien zu entfernen sind.

Die RemoveFiles-Aktion kann auch von Autor*innen angegebene Dateien entfernen, die nicht durch die InstallFiles-Aktion installiert wurden. Diese Dateien werden in der RemoveFile-Tabelle angegeben. Jede dieser Dateien wird durch einen Link zu einem Eintrag in der Component-Tabelle abgegrenzt. Dateien, deren Komponenten in einen aktiven Aktionszustand aufgelöst werden (d. h. nicht „Aus“ oder „Null“), werden entfernt, wenn die Datei im angegebenen Verzeichnis vorhanden ist. Bei der erstmaligen Installation der verknüpften Komponente, während einer Neuinstallation und beim Entfernen der verknüpften Komponente wird versucht, die in der RemoveFile-Tabelle angegebenen Dateien zu entfernen.

Mit der RemoveFiles-Aktion können auch Ordner entfernt werden. Ein leerer Ordner wird entfernt, wenn der Wert in der Spalte „FileName“ der RemoveFile-Tabelle NULL ist.

Beim Entfernen zuvor installierter Dateien fragt die RemoveFiles-Aktion die gleichen Felder in den gleichen Tabellen ab, die auch von der InstallFiles-Aktion abgefragt werden. Die einzige Ausnahme ist, dass die Media-Tabelle nicht von der RemoveFiles-Aktion verwendet wird.

Der Name der Zieldatei kann in lokalisiertem Text in der Spalte „FileName“ der RemoveFile-Tabelle angegeben werden.