Freigeben über

InstallFiles-Aktion

  • Artikel

Die InstallFiles-Aktion kopiert Dateien, die in der Dateitabelle angegeben sind, aus dem Quellverzeichnis in das Zielverzeichnis.

Sequenzeinschränkungen

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

ActionData-Nachrichten

Feld Beschreibung der Aktionsdaten
[1] Bezeichner der installierten Datei.
[6] Größe der installierten Datei in Byte.
[9] Bezeichner der installierten Datei des Verzeichnisses.

 

Bemerkungen

Die InstallFiles-Aktion wird auf Dateien ausgeführt, die in der Dateitabelleangegeben sind. Jede Datei wird basierend auf dem Installationsstatus der zugeordneten Komponente der Datei in der Component-Tabelleinstalliert. Nur die Dateien, deren Komponenten in den msiInstallStatelocal- Zustand aufgelöst werden, sind für das Kopieren berechtigt.

Die InstallFiles-Aktion implementiert die folgenden Spalten der Dateitabelle.

  • Die Spalte "FileName" gibt den Zieldateinamen an.
  • In der Spalte "Version" wird die Dateiversion angegeben.
  • In der Spalte "Attribute" werden die Datei- und Installationsattribute-Flagbits angegeben.
  • Die Spalte "Datei" gibt das eindeutige Dateitoken an.
  • Die Spalte "FileSize" gibt die nicht komprimierte Dateigröße in Byte an.
  • In der Spalte "Sprache" wird der Dateisprachenbezeichner angegeben.
  • Die Spalte "Sequenz" gibt die Sequenznummer auf Medien an.

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

  • Die spalte Directory_ gibt einen Verweis auf eine Verzeichnistabelle Element an.
  • Die Spalte "Komponente" gibt einen eindeutigen Namen für das Komponentenelement an.

Die angegebene Datei wird nur kopiert, wenn eine der folgenden Werte zutrifft:

  • Die Datei ist derzeit nicht auf dem lokalen Computer installiert.
  • Die Datei befindet sich auf dem lokalen Computer, hat jedoch eine niedrigere Versionsnummer als die Datei in der Dateitabelle.
  • Die Datei befindet sich auf dem lokalen Computer, aber es gibt keine zugeordnete Versionsnummer.

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

Wenn sich das Quellverzeichnis für eine zu kopierende Datei auf Wechselmedien wie einem Diskettendatenträger oder CD-ROM befindet, überprüft die InstallFiles-Aktion, ob das richtige Quellmedium eingefügt wird, bevor Sie versuchen, die Datei zu kopieren. Die InstallFiles sucht nach Medien des gleichen Wechseltyps mit einem Volume Bezeichnung, die dem in der Spalte "VolumeLabel" der Media-Tabelle angegebenen Wert entspricht. Wenn ein übereinstimmende bereitgestelltes Volume gefunden wird, wird der Dateikopievorgang fortgesetzt. Wenn keine Übereinstimmung gefunden wird, fordert ein Dialogfeld an, dass der Benutzer die richtigen Medien einfügt. In diesem Fall verwendet das Dialogfeld den Mediennamen in der Spalte "DiskPrompt" der Media-Tabelle als Teil der Eingabeaufforderung.

Vorsicht muss ausgeführt werden, da die InstallFiles-Aktion eine originale Datei löschen und nicht ersetzen kann. Dies tritt auf, wenn bei der InstallFiles-Aktion beim Ersetzen einer älteren Datei ein Fehler auftritt und der Benutzer den Fehler ignoriert. Das Standardverhalten des Installers besteht darin, eine alte Datei zu löschen, bevor sichergestellt wird, dass die neue Datei ordnungsgemäß kopiert wird.

Die vom Installationsprogramm verwendeten Dateiversionsverwaltungsregeln finden Sie unter Dateiversionsregeln.