Structured Storage Serialized Property Set Format

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

Eigenschaftensätze bestehen aus einem markierten Abschnitt von Werten, bei dem 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 Eigenschaftenbezeichner, 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 Formatstruktur für serialisierte COM-Eigenschaften nicht verarbeiten. Weitere Informationen finden Sie in den folgenden Themen:

Alle Datenelemente innerhalb eines Eigenschaftensets werden in intel-Darstellung (d. h. in Little-Endian-Byte-Reihenfolge) gespeichert.

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

  • Eigenschaftensätze ermöglichen es verschiedenen Anwendungen, eigene unabhängige Eigenschaftensä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 In-Memory- oder On-Disk-Speichers gespeichert werden kann. Weitere Informationen und empfohlene Konventionen zum Erstellen des Zeichenfolgennamens für das Speicherobjekt finden Sie unter Storage Object Naming Conventions.
  • Eigenschaftensätze ermöglichen das Hinzufügen eines Wörterbuchs mit Anzeigenamen, die den Inhalt beschreiben. Es wird eine Reihe von Konventionen für die Auswahl von Eigenschaftsnamen empfohlen. Weitere Informationen zu diesem optionalen Wörterbuch finden Sie unter Reserved Property Identifiers, einschließlich Eigenschaften-ID 0.

Der Eigenschaftensatzstream ist in drei Hauptteile unterteilt:

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

Die Gesamtlänge des Eigenschaftensatzstreams muss kleiner oder gleich 256.000 sein. In den folgenden Abschnitten, Property Set Header, Format Identifier/Offset Pairund Section (einschließlich Eigenschaftenbezeichner/Offsetpaare)mit unterstützenden Themen, werden die einzelnen Komponenten beschrieben, aus denen das Eigenschaftensatz-Datenformat erstellt wird.

Hinweis

In früheren Versionen dieses Dokuments wurden Erweiterungen des Eigenschaftssatzstreams beschrieben, in denen mehr als ein Abschnitt zulässig ist. Dieser Abschnitt wurde jedoch überarbeitet, um einen Abschnitt im Eigenschaftenstream zur Verfügung zu stellen. Die einzige Ausnahme sind Die DocumentSummaryInformation- und UserDefined-Eigenschaftensätze.