IPropertyStorage-Schnittstelle (propidl.h)

Artikel
03/04/2024

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)