Dateitabelle

Die Dateitabelle enthält eine vollständige Liste der Quelldateien mit ihren verschiedenen Attributen, geordnet nach einem eindeutigen, nicht lokalisierten Bezeichner. Dateien können auf dem Quellmedium als einzelne Dateien gespeichert oder in einer Schränkdatei komprimiert werden. Weitere Informationen finden Sie unter Verwenden von Schränken und komprimierten Quellen.

Die Dateitabelle enthält die folgenden Spalten.

Spalte Typ Schlüssel Nullwerte zulässig
Datei Identifier J N
Komponente_ Identifier N N
FileName Filename N N
FileSize DoubleInteger N N
Version Version N J
Sprache Sprache N J
Attributes Integer N J
Sequenz Integer N N

Spalten

Datei

Ein nicht lokalisiertes Token, das die Datei eindeutig identifiziert. Bei diesem Feld wird die Groß-/Kleinschreibung nicht beachtet. Weisen Sie verschiedenen Dateien keine Bezeichner zu, die sich nur durch ihre Case unterscheiden.

Komponente_

Der externe Schlüssel in der ersten Spalte der Komponententabelle. Dieses Feld identifiziert die Komponente, die die Datei steuert.

Dateiname

Der für die Installation verwendete Dateiname. Der Name kann lokalisiert werden.

Da bei einigen Webservern die Kleinschreibung beachtet werden kann, sollte FileName genau mit dem Fall der Quelldateien übereinstimmen, um die Unterstützung von Internetdownloads sicherzustellen.

Dateigröße

Dies ist die Größe der Datei in Byte. Dies muss eine nicht negative Zahl sein.

Version

Dieses Feld ist die Versionszeichenfolge für eine Datei mit Versionsinformationen. Dieses Feld ist für Dateien ohne Versionsversion leer. Die in dieses Feld eingegebene Dateiversion muss mit der Version der Datei identisch sein, die im Installationspaket enthalten ist.

Das Feld Version kann auch so festgelegt werden, dass es den Primärschlüssel eines anderen Datensatzes in der Tabelle Datei enthält. Die Datei, auf die verwiesen wird, bestimmt dann die Versionslogik für diese Datei. Weitere Informationen finden Sie unter Begleitdateien. Beachten Sie, dass diese Datei nicht als Begleitdatei angegeben werden darf, wenn sie der Schlüsselpfad für ihre Komponente ist.

Sprache

Eine Liste der durch Kommas getrennten Dezimalsprach-IDs.

Schriftartdateien sollten nicht mit einer Sprach-ID verfasst werden, da Schriftarten keine eingebettete Sprach-ID-Ressource haben. Daher sollte diese Spalte für Schriftartdateien NULL bleiben.

Attribute

Die ganze Zahl, die Bitflags enthält, die Dateiattribute darstellen.

Die folgende Tabelle zeigt die Definition des Bitfelds.

Konstante Hexadezimal Decimal Beschreibung
msidbFileAttributesReadOnly 0x000001 1 Schreibgeschützt
msidbFileAttributesHidden 0x000002 2 Ausgeblendet
msidbFileAttributesSystem 0x000004 4 System
msidbFileAttributesVital 0x000200 512 Die Datei ist wichtig für den genauen Betrieb der Komponente, zu der sie gehört. Wenn bei der Installation einer Datei mit dem Attribut msidbFileAttributesVital ein Fehler auftritt, wird die Installation beendet und ein Rollback ausgeführt. In diesem Fall zeigt der Installer ein Dialogfeld ohne die Schaltfläche Ignorieren an. Wenn dieses Attribut nicht festgelegt ist und bei der Installation der Datei ein Fehler auftritt, zeigt der Installer ein Dialogfeld mit der Schaltfläche Ignorieren an. In diesem Fall kann der Benutzer den Fehler beim Installieren der Datei ignorieren und fortfahren.
msidbFileAttributesChecksum 0x000400 1024 Die Datei enthält eine gültige Prüfsumme. Eine Prüfsumme ist erforderlich, um eine beschädigte Datei zu reparieren.
msidbFileAttributesPatchAdded 0x001000 4096 Dieses Bit darf nur von einem Patch und hinzugefügt werden, wenn die Datei durch den Patch hinzugefügt wird.
msidbFileAttributesNoncompressed 0x002000 8192 Der Quelltyp der Datei ist nicht komprimiert. Wenn diese Eigenschaft festgelegt ist, ignorieren Sie die Eigenschaft Zusammenfassung der Wortanzahl. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt sind, wird der Komprimierungszustand der Datei von der Eigenschaft Zusammenfassung der Wortanzahl angegeben. Legen Sie nicht sowohl msidbFileAttributesNoncompressed als auch msidbFileAttributesCompressed fest.
msidbFileAttributesCompressed 0x004000 16384 Der Quelltyp der Datei ist komprimiert. Wenn diese Eigenschaft festgelegt ist, ignorieren Sie die Eigenschaft Zusammenfassung der Wortanzahl. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt sind, wird der Komprimierungszustand der Datei von der Eigenschaft Zusammenfassung der Wortanzahl angegeben. Legen Sie nicht sowohl msidbFileAttributesNoncompressed als auch msidbFileAttributesCompressed fest.

Wenn das msidbFileAttributesVital-Bit in der Spalte Attribute festgelegt ist und die Komponente, zu der die Datei gehört, für die Installation ausgewählt ist, muss das Installationsprogramm diese Datei installieren können, damit die Installation erfolgreich abgeschlossen werden kann. Wenn das Installationsprogramm die Datei aus irgendeinem Grund nicht installieren kann (z. B. wenn sich die Quelldatei nicht im Quellimage befinden kann), wird ein Fehlerdialogfeld mit den Optionen "Wiederholen" oder "Abbrechen" angezeigt. Für eine Datei, für die msidbFileAttributesVital nicht festgelegt ist, sind die Optionen im Falle eines Installationsfehlers "Abort", "Retry" und "Ignore" (d. h., der Benutzer hat die Möglichkeit, die Installation erfolgreich zu abschließen, ohne diese Datei zu installieren).

Das msidbFileAttributesChecksum-Bit in der Spalte Attribute sollte für jede ausführbare Datei in der Installation festgelegt werden, in der eine gültige Prüfsumme im PE-Dateiheader (Portable Executable) gespeichert ist. Nur die Dateien, für die dieses Bit festgelegt ist, werden während einer Neuinstallation auf eine gültige Prüfsumme überprüft. Weitere Informationen finden Sie unter REINSTALLMODE.

Sequenz

Sequenzposition dieser Datei auf den Medienbildern. Diese Reihenfolge muss der Reihenfolge der Dateien im Schaltet entsprechen, wenn die Dateien komprimiert sind. Die ganzen Zahlen in diesem Feld müssen gleich oder größer als 1 sein.

Die Sequenznummern in der Spalte Sequenz werden verwendet, um sowohl die Installationsreihenfolge für Dateien als auch das Quellmedium anzugeben, auf dem sich die Datei befindet (in Verbindung mit der Medientabelle). Angenommen, eine Datei hat die Sequenznummer 92. Um den Quelldatenträger zu ermitteln, auf dem sich diese Datei befindet, suchen Sie in der Tabelle Medien nach dem Eintrag mit dem kleinsten Wert der letzten Sequenz, der größer als 92 ist.

Obwohl komprimierten Dateien interne Sequenznummern innerhalb von Schränken zugewiesen werden, müssen diese absoluten Zahlen nicht mit den Sequenznummern in der Dateitabelle übereinstimmen. Es ist jedoch wichtig, dass die Sequenz der Dateien in der Tabelle File mit der Sequenz der Dateien in den Schränken identisch ist.

Für Dateien, die nicht komprimiert sind, müssen die Sequenznummern nicht eindeutig sein. Wenn beispielsweise alle Dateien dekomprimiert sind und sich alle auf einem Datenträger befinden, können Sie allen Dateien die gleiche Sequenznummer geben.

Der höchstwert beträgt 32767 Dateien. Informationen zum Erstellen eines Windows Installer-Pakets mit mehr Dateien finden Sie unter Erstellen eines großen Pakets.

Bemerkungen

Die Aktionen InstallFiles und RemoveFiles in den Sequenztabellen verarbeiten die Informationen in dieser Tabelle. Informationen zur Verwendung von Sequenztabellen finden Sie unter Verwenden einer Sequenztabelle.

Die Tabelle wird anfänglich aus der Dateiliste generiert, aber wenn die Komprimierung des Schränkes verwendet wird, wird die Tabelle aus der Ausgabe der Komprimierungs-Engine neu generiert. Weitere Informationen finden Sie unter Cabinet Files.

Um eine vorhandene Datei während der Installation auf dem Computer des Benutzers zu verschieben, verwenden Sie die MoveFiles-Aktion und die MoveFile-Tabelle. Um eine Datei an mehreren Speicherorten zu installieren, verwenden Sie die DuplicateFiles-Aktion und die DuplicateFile-Tabelle.

In der folgenden Tabelle werden die möglichen Kombinationen von Werten in der Spalte Version und der Spalte Sprache zusammengefasst. Weitere Informationen finden Sie unter Regeln für die Dateiversionsversion.

Version Sprache Beschreibung
1.2.3.4 1033 Version und Sprache.
1.2.3.4 (NULL) Die Version, aber keine Sprache.
1.2.3.4 0 Version und Sprache sind neutral.
Testdb (NULL) Die Begleitdatei ohne zugeordnete Sprache.
Testdb 1033 Die Begleitdatei und -sprache.
(NULL) 1033 Keine Version, aber ihr ist eine Sprache zugeordnet (typelib, helpfile).

Weitere Informationen finden Sie unter MsiLockPermissionsEx Table und LockPermissions Table.

Validierung

ICE02
ICE03
ICE04
ICE06
ICE18
ICE30
ICE32
ICE35
ICE39
ICE42
ICE45
ICE50
ICE51
ICE54
ICE55
ICE57
ICE59
ICE60
ICE67
ICE69
ICE76
ICE91