IPropertyStorage-Schnittstelle (propidl.h)

Artikel
08/25/2023

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 null oder mehr IPropertyStorage-Instanzen verwalten.

Jede Eigenschaft innerhalb eines Eigenschaftssatzes wird durch einen Eigenschaftenbezeichner (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 Verteiler-IDs, die in Automation dispid-Eigenschaftsnamenstags verwendet werden. Ein Unterschied besteht darin, dass die allgemeine Verwendung von Eigenschafts-ID-Werten null und 1 in IPropertyStorage verboten ist, während eine solche Einschränkung in IDispatch nicht vorhanden ist. Darüber hinaus gibt es erhebliche Überschneidungen zwischen den Datentypen für Eigenschaftswerte, die in IPropertyStorage und IDispatch verwendet werden können, die Eigenschaftensätze sind nicht identisch. Datentypen für persistente Eigenschaften, 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. Nicht einfache Eigenschaftensätze können mehrere komplexe Eigenschaftstypen enthalten, die nicht in einem einfachen Eigenschaftensatz gehalten werden können. Weitere Informationen finden Sie unter Speicher- und Streamobjekte für einen Eigenschaftensatz.

Vererbung

Die IPropertyStorage-Schnittstelle erbt von der IUnknown-Schnittstelle . IPropertyStorage verfügt auch über die folgenden Typen von Membern:

Methoden

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


IPropertyStorage::Commit Die IPropertyStorage::Commit-Methode speichert Änderungen, die an einem Eigenschaftsspeicherobjekt vorgenommen wurden, am ü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 angegebene Zeichenfolgennamen aus dem aktuellen Eigenschaftensatz. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum Die IPropertyStorage::Enum-Methode erstellt ein enumerator-Objekt, das zum Auflisten von Daten vom Typ STATPROPSTG entwickelt wurde, 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 festgelegt 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 von der Implementierung unterstützt.
IPropertyStorage::Stat Die IPropertyStorage::Stat-Methode ruft Informationen zum aktuellen offenen Eigenschaftensatz 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 ZeichenfolgeN-IPropertyStoragenames einem angegebenen Array von Eigenschaften-IDs im aktuellen Eigenschaftensatz zu.

Anforderungen


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)