Freigeben über


IPropertyStorage-Schnittstelle (propidl.h)

Die IPropertyStorage-Schnittstelle verwaltet die persistenten Eigenschaften eines einzelnen Eigenschaftensatzes. Persistente Eigenschaften bestehen aus Informationen, die dauerhaft in einem Eigenschaftensatz gespeichert werden können, z. B. die einer Datei zugeordneten Zusammenfassungsinformationen. Dies steht im Gegensatz zu Laufzeiteigenschaften, die Steuerelementen und Automatisierung zugeordnet sind, die verwendet werden können, um das Systemverhalten zu beeinflussen. Verwenden Sie die Methoden der IPropertySetStorage-Schnittstelle , um einen persistenten Eigenschaftensatz zu erstellen oder zu öffnen. Ein instance der IPropertySetStorage-Schnittstelle kann 0 oder mehr IPropertyStorage-Instanzen verwalten.

Jede Eigenschaft innerhalb eines Eigenschaftensatzes wird durch einen Eigenschaftsbezeichner (ID) identifiziert, einen vier-Byte-ULONG-Wert , der für diesen Satz eindeutig ist. Sie können einer Eigenschaft auch über die IPropertyStorage-Schnittstelle einen Zeichenfolgennamen zuweisen.

Eigenschaften-IDs unterscheiden sich von den Verteilungs-IDs, die in Automation dispid-Eigenschaftsnamenstags verwendet werden. Ein Unterschied besteht darin, dass die allgemeine Verwendung der Eigenschafts-ID-Werte 0 und 1 in IPropertyStorage verboten ist, während in IDispatch keine solche Einschränkung vorhanden ist. Darüber hinaus gibt es zwar erhebliche Überschneidungen zwischen den Datentypen für Eigenschaftswerte, die in IPropertyStorage und IDispatch verwendet werden können, die Eigenschaftensätze sind jedoch nicht identisch. Persistente Eigenschaftsdatentypen, die in IPropertyStorage-Methoden verwendet werden, werden in der PROPVARIANT-Struktur definiert.

Die IPropertyStorage-Schnittstelle kann für den Zugriff auf einfache und nicht einfache Eigenschaftensätze verwendet werden. Nonsimple-Eigenschaftssätze können mehrere komplexe Eigenschaftentypen enthalten, die nicht in einem einfachen Eigenschaftensatz gespeichert werden können. Weitere Informationen finden Sie unter Storage and Stream Objects for a Property Set.

Vererbung

Die IPropertyStorage-Schnittstelle erbt von der IUnknown-Schnittstelle . IPropertyStorage verfügt auch über folgende Membertypen:

Methoden

Die IPropertyStorage-Schnittstelle verfügt über diese Methoden.

 
IPropertyStorage::Commit

Die IPropertyStorage::Commit-Methode speichert Änderungen, die an einem Eigenschaftsspeicherobjekt vorgenommen wurden, im übergeordneten Speicherobjekt.
IPropertyStorage::D eleteMultiple

Die IPropertyStorage::D eleteMultiple-Methode löscht so viele der angegebenen Eigenschaften, wie in diesem Eigenschaftensatz vorhanden sind.
IPropertyStorage::D eletePropertyNames

Die DeletePropertyNames-Methode löscht die angegebenen Zeichenfolgennamen aus dem aktuellen Eigenschaftensatz. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum

Die IPropertyStorage::Enum-Methode erstellt ein Enumeratorobjekt zum Aufzählen von Daten vom Typ STATPROPSTG, das Informationen zum aktuellen Eigenschaftensatz enthält.
IPropertyStorage::ReadMultiple

Die IPropertyStorage::ReadMultiple-Methode liest die angegebenen Eigenschaften aus dem aktuellen Eigenschaftensatz.
IPropertyStorage::ReadPropertyNames

Die IPropertyStorage::ReadPropertyNames-Methode ruft alle vorhandenen Zeichenfolgennamen für die angegebenen Eigenschaften-IDs ab.
IPropertyStorage::Revert

Die IPropertyStorage::Revert-Methode verwirft alle Änderungen am benannten Eigenschaftensatz, seit sie zuletzt geöffnet wurde, oder verwirft Änderungen, die zuletzt für den Eigenschaftensatz committet wurden.
IPropertyStorage::SetClass

Die IPropertyStorage::SetClass-Methode weist dem aktuellen Eigenschaftsspeicherobjekt eine neue CLSID zu und speichert die CLSID dauerhaft mit dem -Objekt.
IPropertyStorage::SetTimes

Die IPropertyStorage::SetTimes-Methode legt die Änderungs-, Zugriffs- und Erstellungszeiten dieses Eigenschaftssatzes fest, sofern sie von der Implementierung unterstützt wird.
IPropertyStorage::Stat

Die IPropertyStorage::Stat-Methode ruft Informationen zum aktuellen Open-Eigenschaftssatz ab. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple

Die IPropertyStorage::WriteMultiple-Methode schreibt eine angegebene Gruppe von Eigenschaften in den aktuellen Eigenschaftensatz.
IPropertyStorage::WritePropertyNames

Die IPropertyStorage::WritePropertyNames-Methode weist die Zeichenfolge IPropertyStoragenames einem angegebenen Array von Eigenschaften-IDs im aktuellen Eigenschaftensatz zu.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile propidl.h (include Objbase.h, Propidlbase.h)

Weitere Informationen

IEnumSTATPROPSETSTG

IEnumSTATPROPSTG

IPropertySetStorage

Implementierung der IPropertyStorage-Compound-Datei

IPropertyStorage-NTFS-Dateisystemimplementierung

IPropertyStorage-Eigenständige Implementierung

Verwalten von Eigenschaften

PROPVARIANT

Überlegungen zur Eigenschaftsspeicherung

STATPROPSETSTG

STATPROPSTG

Beispiele