Strukturiertes Storage Serialisiertes Eigenschaftensatzformat

Persistente Eigenschaftssätze bieten eine Option zum Speichern von Daten innerhalb von Dateisystementitäten. Es wird empfohlen, sie zu erstellen und zu verwalten, verwenden Sie die in Eigenschaften und Eigenschaftssätzen beschriebenen IPropertySetStorage- und IPropertyStorage-Schnittstellen.

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

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

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

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

  • Eigenschaftssätze ermöglichen es verschiedenen Anwendungen, eigene unabhängige Eigenschaftssätze für die Anwendung zu erstellen.
  • Eigenschaftssätze können in einer einzelnen IStream-Instanz oder in einer IStorage-Instanz gespeichert werden, die mehrere Streams enthält. Eigenschaftssätze sind einfach ein anderer Datentyp, der in vielen verschiedenen Formen eines Speichers oder auf dem Datenträgerspeicher gespeichert werden kann. Weitere Informationen und empfohlene Konventionen zum Erstellen des Zeichenfolgennamens für das Speicherobjekt finden Sie unter Storage Objektbenennungskonventionen.
  • Eigenschaftssätze ermöglichen es, dass ein Wörterbuch mit Anzeigenamen enthalten ist, die den Inhalt beschreiben. Es wird eine Reihe von Konventionen zum Auswählen von Eigenschaftennamen empfohlen. Weitere Informationen zu diesem optionalen Wörterbuch finden Sie unter Reservierte Eigenschaftsbezeichner, einschließlich Eigenschafts-ID 0.

Der Eigenschaftensatzdatenstrom ist in drei Hauptteile unterteilt:

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

Die Gesamtlänge des Eigenschaftssatzdatenstroms muss kleiner oder gleich 256K sein. Die folgenden Abschnitte, Property Set Header, Format Identifier/Offset Pair und Section (einschließlich Eigenschaftsbezeichner/Offset-Paare) mit unterstützenden Themen beschreiben die einzelnen Komponenten, die das Eigenschaftsdatenformat verfassen.

Hinweis

In früheren Versionen dieses Dokuments wurden Erweiterungen für den Eigenschaftssatzdatenstrom mit mehr als einem Abschnitt zulässig beschrieben, aber das wurde überarbeitet, um einen Abschnitt im Eigenschaftendatenstrom bereitzustellen. Die einzige Ausnahme ist "DocumentSummaryInformation" und "UserDefined"-Eigenschaftssätze.