Dateitabelle

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

Die Dateitabelle enthält die folgenden Spalten.

Spalte	Art	Schlüssel	Nullable
Datei	Bezeichner	Y	N
Bestandteil_	Bezeichner	N	N
Dateiname	Dateiname	N	N
FileSize	DoubleInteger-	N	N
Version	Version	N	Y
Sprache	Sprache	N	Y
Attribute	ganze Zahl	N	Y
Reihenfolge	ganze Zahl	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, die nur von ihrem Fall abweichen, keine Bezeichner zu.

Component_

Der externe Schlüssel in der ersten Spalte der Komponententabelle. 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 die Groß-/Kleinschreibung beachtet werden kann, sollte FileName genau mit der Groß-/Kleinschreibung der Quelldateien übereinstimmen, um die Unterstützung von Internetdownloads sicherzustellen.

FileSize

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

Version

Dieses Feld ist die Versionszeichenfolge für eine versionsbasierte Datei. Dieses Feld ist für nicht versionsbezogene Dateien 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 er den Primärschlüssel eines anderen Datensatzes in der Dateitabelle enthält. Die referenzierte Datei bestimmt dann die Versionsverwaltungslogik für diese Datei. Weitere Informationen finden Sie unter Begleitdateien. Beachten Sie, dass diese Datei, wenn sie der Schlüsselpfad für die Komponente ist, nicht als Begleitdatei angegeben werden darf.

Sprache

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

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

Attribute

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

Die folgende Tabelle zeigt die Definition des Bitfelds.

Konstante	Hexadezimal	Dezimal	Beschreibung
msidbFileAttributesReadOnly	0x000001	1	Read-Only
msidbFileAttributesHidden	0x000002	2	Versteckt
msidbFileAttributesSystem-	0x000004	4	System
msidbFileAttributesVital	0x000200	512	Die Datei ist entscheidend für den genauen Betrieb der Komponente, zu der sie gehört. Wenn die Installation einer Datei mit dem attribut msidbFileAttributesVital fehlschlägt, wird die Installation beendet und zurückgesetzt. In diesem Fall zeigt das Installationsprogramm ein Dialogfeld ohne Schaltfläche "Ignorieren" an. Wenn dieses Attribut nicht festgelegt ist und die Installation der Datei fehlschlägt, zeigt das Installationsprogramm ein Dialogfeld mit einer Schaltfläche "Ignorieren" an. In diesem Fall kann der Benutzer entscheiden, den Fehler bei der Installation der Datei zu ignorieren und den Vorgang fortzusetzen.
msidbFileAttributesChecksum-	0x000400	1024	Die Datei enthält eine gültige Prüfsumme. Zum Reparieren einer Datei, die beschädigt wurde, ist eine Prüfsumme erforderlich.
msidbFileAttributesPatchAdded-	0x001000	4096	Dieses Bit darf nur von einem Patch hinzugefügt werden und wenn die Datei vom Patch hinzugefügt wird.
msidbFileAttributesNoncompressed	0x002000	8192	Der Quelltyp der Datei wird nicht komprimiert. Wenn festgelegt, ignorieren Sie die Word Count Summary-Eigenschaft. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt werden, wird der Komprimierungsstatus der Datei durch die Word Count Summary-Eigenschaft angegeben. Legen Sie nicht beide msidbFileAttributesNoncompressed und msidbFileAttributesCompressedfest.
msidbFileAttributesCompressed	0x004000	16384	Der Quelltyp der Datei wird komprimiert. Wenn festgelegt, ignorieren Sie die Word Count Summary-Eigenschaft. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt werden, wird der Komprimierungsstatus der Datei durch die Word Count Summary-Eigenschaft angegeben. Legen Sie nicht beide msidbFileAttributesNoncompressed und msidbFileAttributesCompressedfest.

 

Wenn die msidbFileAttributesVital Bit innerhalb 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 befindet), wird ein Fehlerdialogfeld mit den Optionen "Wiederholen" oder "Abbrechen" angezeigt. Bei einer Datei, die nicht über msidbFileAttributesVital festgelegt ist, sind die Optionen im Falle eines Installationsfehlers "Abort", "Wiederholen" und "Ignorieren" (d. a. der Benutzer hat die Möglichkeit, die Installation erfolgreich abzuschließen, ohne diese Datei zu installieren).

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

Sequenz

Sequenzposition dieser Datei auf den Medienbildern. Diese Reihenfolge muss der Reihenfolge der Dateien im Cab entsprechen, wenn die Dateien komprimiert werden. 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 Reihenfolge der Installation für Dateien als auch die Quellmedien anzugeben, auf denen sich die Datei befindet (in Verbindung mit der Medientabelle). Angenommen, eine Datei hat eine Sequenznummer von 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 der letzten Sequenz, der größer als 92 ist.

Obwohl komprimierte Dateien internen Sequenznummern innerhalb von Cabs zugewiesen werden, müssen diese absoluten Zahlen nicht mit den Sequenznummern in der Dateitabelle übereinstimmen. Es ist jedoch wichtig, dass die Abfolge der Dateien in der Dateitabelle mit der Abfolge der Dateien innerhalb der Cabs identisch ist.

Bei Dateien, die nicht komprimiert sind, müssen die Sequenznummern nicht eindeutig sein. Wenn beispielsweise alle Ihre Dateien nicht komprimiert sind und sich alle auf einem Datenträger befinden, könnten Sie allen Dateien die gleiche Sequenznummer zugeben.

Die maximale Grenze beträgt 32767 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 aktionen in den Sequenztabellen verarbeiten die Informationen in dieser Tabelle. Informationen zur Verwendung von Sequenztabellenfinden Sie unter Verwenden einer Sequenztabelle.

Die Tabelle wird zunächst aus der Dateiliste generiert, aber wenn cab-Komprimierung verwendet wird, wird die Tabelle von der Ausgabe des Komprimierungsmoduls 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 Action und MoveFile Table. Um eine Datei an mehreren Speicherorten zu installieren, verwenden Sie die DuplicateFiles Action und die DuplicateFile Table.

In der folgenden Tabelle sind die möglichen Wertekombinationen in der Spalte "Version" und der Spalte "Sprache" zusammengefasst. Weitere Informationen finden Sie unter Dateiversionsregeln.

Version	Sprache	Beschreibung
1.2.3.4	1033	Die Version und Sprache.
1.2.3.4	(Null)	Die Version, aber keine Sprache.
1.2.3.4	0	Die Version und Sprache sind neutral.
Testdb	(Null)	Die Begleitdatei ohne zugeordnete Sprache.
Testdb	1033	Die Begleitdatei und Sprache.
(Null)	1033	Keine Version, hat aber eine sprache zugeordnet (d. a. typelib, helpfile).

 

Weitere Informationen finden Sie in der 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-