Freigeben über

InstallFiles-Aktion

  • Artikel

Die InstallFiles-Aktion kopiert die in der File-Tabelle angegebenen Dateien aus dem Quellverzeichnis in das Zielverzeichnis.

Sequenzeinschränkungen

Die InstallFiles-Aktion muss nach der InstallValidate-Aktion und vor dateiabhängigen Aktionen erfolgen.

ActionData-Meldungen

Feld Beschreibung der Aktionsdaten
[1] Bezeichner der installierten Datei.
[6] Größe der installierten Datei in Byte.
[9] Bezeichner des Verzeichnisses, in dem sich die installierte Datei befindet.

 

Bemerkungen

Die InstallFiles-Aktion wird für Dateien ausgeführt, die in der File-Tabelle angegeben sind. Jede Datei wird basierend auf dem Installationszustand ihrer zugeordneten Komponente in der Component-Tabelle installiert. Nur Dateien, deren Komponenten in den Zustand msiInstallStatelocal aufgelöst werden, können kopiert werden.

Die Aktion „InstallFiles“ implementiert die folgenden Spalten der File-Tabelle.

  • Die Spalte „FileName“ gibt den Namen der Zieldatei an.
  • Die Spalte „Version“ gibt die Dateiversion an.
  • Die Spalte „Attributes“ gibt die Flagbits für Datei- und Installationsattribute an.
  • Die Spalte „File“ gibt das eindeutige Dateitoken an.
  • Die Spalte „FileSize“ gibt die unkomprimierte Dateigröße in Byte an.
  • In der Spalte „Language“ wird der Dateisprachbezeichner angegeben.
  • Die Spalte „Sequence“ gibt die Sequenznummer auf Medien an.

Die Aktion „InstallFiles“ implementiert die folgenden Spalten der Component-Tabelle.

  • Die Spalte „Directory_“ gibt einen Verweis auf ein Element der Directory-Tabelle an.
  • Die Spalte „Component“ gibt einen eindeutigen Namen für das Komponentenelement an.

Die angegebene Datei wird nur kopiert, wenn eine der folgenden Bedingungen erfüllt wird:

  • Die Datei ist derzeit nicht auf dem lokalen Computer installiert.
  • Die Datei befindet sich auf dem lokalen Computer, weist jedoch eine niedrigere Versionsnummer als die Datei in der File-Tabelle auf.
  • Die Datei befindet sich auf dem lokalen Computer, ihr ist jedoch keine Versionsnummer zugeordnet.

Das Quellverzeichnis für jede zu kopierende Datei wird durch den sourceMode (Quellmodus) bestimmt, der wiederum vom Wert in der Spalte „Cabinet“ der Media-Tabelle abhängt. Eine vollständige Erläuterung des Quellmodus finden Sie unter Media-Tabelle.

Wenn sich das Quellverzeichnis für eine zu kopierende Datei auf Wechselmedien wie einer Diskette oder einer CD-ROM befindet, überprüft die Aktion „InstallFiles“, ob das richtige Quellmedium eingelegt ist, bevor versucht wird, die Datei zu kopieren. InstallFiles sucht nach Medien desselben Wechselmedientyps mit einer volume-Beschriftung, die mit dem Wert in der Spalte „VolumeLabel“ der Media-Tabelle übereinstimmt. Wird ein passendes eingebundenes Volume gefunden, wird der Dateikopiervorgang fortgesetzt. Wenn keine Übereinstimmung gefunden wird, fordert ein Dialogfeld zum Einlegen des richtigen Mediums auf. In diesem Fall verwendet das Dialogfeld in der Aufforderung den Mediennamen, der in der Spalte „DiskPrompt“ der Media-Tabelle gefunden wird.

Es ist Vorsicht geboten, da die Aktion „InstallFiles“ eine Originaldatei löschen kann, ohne sie zu ersetzen. Dies geschieht, wenn bei der Aktion „InstallFiles“ beim Ersetzen einer älteren Datei ein Fehler auftritt und der/die Benutzer*in den Fehler ignoriert. Das Standardverhalten des Installers besteht darin, eine alte Datei zu löschen, bevor sichergestellt wird, dass die neue Datei ordnungsgemäß kopiert wurde.

Informationen zu den vom Installer verwendeten Regeln zur Dateiversionsverwaltung finden Sie unter Dateiversionsverwaltungsregeln.