Serialisiertes Eigenschaftssatzformat für strukturierten Speicher

Persistente Eigenschaftensätze bieten eine Option zum Speichern von Daten in Dateisystementitäten. Es wird empfohlen, zum Erstellen und Verwalten der Schnittstellen IPropertySetStorage und IPropertyStorage zu verwenden, die unter Eigenschaften und Eigenschaftensätze beschrieben werden.

Eigenschaftensätze bestehen aus einem markierten Abschnitt mit Werten, wobei der Abschnitt eindeutig durch einen Formatbezeichner (FMTID) identifiziert wird. Jede Eigenschaft besteht aus einem Eigenschaftenbezeichner und einem Typindikator, der einen Wert darstellt. Jeder in einem Eigenschaftensatz gespeicherte Wert verfügt über einen eindeutigen Eigenschaftsbezeichner, der die Eigenschaft unterscheidet. Der Typindikator beschreibt die Darstellung der Daten im Wert.

Wenn Sie die Schnittstellen IPropertySetStorage und IPropertyStorage verwenden, müssen Sie die COM-serialisierte Eigenschaftensatzformatstruktur nicht verarbeiten. Weitere Informationen finden Sie in den aufgeführten Themen:

Alle Datenelemente innerhalb eines Eigenschaftssatzes werden in intel-Darstellung (also in Little-Endian-Bytereihenfolge) gespeichert.

COM definiert ein serialisiertes Standarddatenformat für Eigenschaftssätze. Bei der Behandlung des serialisierten Formats und nicht mit den Schnittstellen weisen Eigenschaftssätze die folgenden Merkmale auf:

• Eigenschaftensätze ermöglichen es verschiedenen Anwendungen, ihre eigenen unabhängigen Eigenschaftssätze zu erstellen, um die Anwendung zu bedienen.
• Eigenschaftensätze können in einem einzelnen IStream-instance oder in einer IStorage-instance gespeichert werden, die mehrere Datenströme enthält. Eigenschaftensätze sind einfach ein weiterer Datentyp, der in vielen verschiedenen Formen eines Speichers im Arbeitsspeicher oder auf dem Datenträger gespeichert werden kann. Weitere Informationen und empfohlene Konventionen zum Erstellen des Zeichenfolgennamens für das Speicherobjekt finden Sie unter Benennungskonventionen für Speicherobjekte.
• Eigenschaftensätze ermöglichen die Aufnahme eines Wörterbuchs mit Anzeigenamen, die den Inhalt beschreiben. Eine Reihe von Konventionen zum Auswählen von Eigenschaftennamen wird empfohlen. Weitere Informationen zu diesem optionalen Wörterbuch finden Sie unter Bezeichner für reservierte Eigenschaften, einschließlich Eigenschafts-ID 0.

Der Eigenschaftensatzstream ist in drei Hauptteile unterteilt:

• Header
• FORMATID/Offset-Paar
• Abschnitt mit den tatsächlichen Eigenschaftensatzwerten

Die Gesamtlänge des Eigenschaftssatzdatenstroms muss kleiner oder gleich 256 KB sein. In den folgenden Abschnitten , Eigenschaftssatzheader, Formatbezeichner/Offsetpaar und Abschnitt (einschließlich Eigenschaftsbezeichner/Offsetpaare) mit unterstützenden Themen werden die einzelnen Komponenten beschrieben, aus denen das Eigenschaftssatzdatenformat besteht.

Hinweis

In früheren Versionen dieses Dokuments wurden Erweiterungen des Eigenschaftssatzstreams mit mehr als einem Abschnitt beschrieben, die jedoch überarbeitet wurden, um einen Abschnitt im Eigenschaftenstream bereitzustellen. Die einzige Ausnahme sind die Eigenschaftensätze DocumentSummaryInformation und UserDefined.