Dateitabelle

Die File-Tabelle enthält eine vollständige Liste der Quelldateien mit ihren verschiedenen Attributen, sortiert nach einem eindeutigen, nicht lokalisierten Bezeichner. Dateien können auf den Quellmedien als einzelne Dateien gespeichert oder in CAB-Dateien komprimiert werden. Weitere Informationen finden Sie unter Verwenden von CAB-Dateien und komprimierten Quellen.

Die MoveFile-Tabelle umfasst die folgenden Spalten.

Spalten

File

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

Component_

Der externe Schlüssel in die erste Spalte der Component-Tabelle. Dieses Feld identifiziert die Komponente, die die Datei steuert.

FileName

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

Da bei einigen Webservern gegebenenfalls die Groß-/Kleinschreibung beachtet wird, muss FileName genau mit der Groß-/Kleinschreibung der Quelldateien übereinstimmen, damit die Unterstützung von Internetdownloads gewährleistet ist.

FileSize

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 versionierte Datei. Dieses Feld ist für Dateien ohne Version 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 File-Tabelle enthält. Die Datei, auf die verwiesen wird, bestimmt dann die Versionsverwaltungslogik 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 die Komponente ist.

Language

Eine Liste von dezimalen Sprach-IDs, die durch Kommas getrennt sind.

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

Attributes

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

Die folgende Tabelle zeigt die Definition des Bitfelds.

Konstant	Hexadezimal	Decimal	BESCHREIBUNG
msidbFileAttributesReadOnly	0x000001	1	Schreibgeschützt
msidbFileAttributesHidden	0x000002	2	Ausgeblendet
msidbFileAttributesSystem	0x000004	4	System
msidbFileAttributesVital	0x000200	512	Die Datei ist für den genauen Betrieb der Komponente entscheidend, zu der sie gehört. Wenn bei der Installation einer Datei mit dem Attribut msidbFileAttributesVital ein Fehler auftritt, wird die Installation gestoppt und ein Rollback ausgeführt. In diesem Fall zeigt das Installationsprogramm 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 können Benutzer*innen den Fehler bei der Installation 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 hinzugefügt werden, und nur dann, wenn die Datei vom Patch hinzugefügt wird.
msidbFileAttributesNoncompressed	0x002000	8192	Der Quelltyp der Datei ist unkomprimiert. Falls festgelegt, ignorieren Sie die Word Count Summary-Eigenschaft. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt ist, wird der Komprimierungsstatus der Datei durch die Word Count Summary-Eigenschaft angegeben. Legen Sie entweder nur msidbFileAttributesNoncompressed oder nur msidbFileAttributesCompressed fest.
msidbFileAttributesCompressed	0x004000	16384	Der Quelltyp der Datei ist komprimiert. Falls festgelegt, ignorieren Sie die Word Count Summary-Eigenschaft. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt ist, wird der Komprimierungsstatus der Datei durch die Word Count Summary-Eigenschaft angegeben. Legen Sie entweder nur msidbFileAttributesNoncompressed oder nur msidbFileAttributesCompressed fest.

 

Wenn das msidbFileAttributesVital-Bit in der Spalte „Attributes“ festgelegt ist, und die Komponente, zu der die Datei gehört, für die Installation ausgewählt ist, muss das Installationsprogramm in der Lage sein, diese Datei zu installieren, damit die Installation erfolgreich abgeschlossen werden kann. Wenn das Installationsprogramm die Datei aus beliebigem Grund nicht installieren kann (z. B. wenn die Quelldatei nicht innerhalb des Quellimages gefunden werden kann), wird ein Fehlerdialogfeld mit der Option „Wiederholen“ oder „Abbrechen“ angezeigt. Für eine Datei, für die msidbFileAttributesVital nicht festgelegt ist, sind im Falle eines Installationsfehlers die Optionen „Abbrechen“, „Wiederholen“ und „Ignorieren“ (d. h. Benutzer*innen haben die Möglichkeit, die Installation erfolgreich abzuschließen, ohne diese Datei zu installieren) verfügbar.

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

Sequence

Sequenzposition dieser Datei in den Medienimages. Diese Reihenfolge muss der Reihenfolge der Dateien in der CAB-Datei entsprechen, wenn die Dateien komprimiert werden. Die ganzen Zahlen in diesem Feld müssen gleich 1 oder größer sein.

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

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

Für Dateien, die nicht komprimiert sind, müssen die Sequenznummern nicht eindeutig sein. Wenn z. B. alle Ihre Dateien nicht komprimiert sind, und sich alle auf einem Datenträger befinden, können Sie für alle Dateien die gleiche Sequenznummer festlegen.

Der maximale Grenzwert beträgt 32.767 Dateien. Informationen zum Erstellen eines Windows Installer-Pakets mit weiteren 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 zunächst aus der Dateiliste generiert, aber wenn die CAB-Dateikomprimierung verwendet wird, wird die Tabelle aus der Ausgabe der Komprimierungsengine neu generiert. Weitere Informationen finden Sie unter CAB-Dateien.

Um eine vorhandene Datei auf dem Computer der Benutzerin/des Benutzers während der Installation 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 sind die möglichen Kombinationen von Werten in der Spalte „Version“ und der Spalte „Language“ zusammengefasst. Weitere Informationen finden Sie unter Dateiversionsverwaltungsregeln.

Weitere Informationen finden Sie unter MsiLockPermissionsEx-Tabelle und LockPermissions-Tabelle.

Validierung

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