Interfaccia IPropertyStorage (propidlbase.h)

Articolo
03/05/2024

L'interfaccia IPropertyStorage gestisce le proprietà persistenti di un singolo set di proprietà. Le proprietà persistenti sono costituite da informazioni che possono essere archiviate in modo permanente in un set di proprietà, ad esempio le informazioni di riepilogo associate a un file. Questo contrasto con le proprietà di runtime associate ai controlli e all'automazione, che possono essere usati per influire sul comportamento del sistema. Usare i metodi dell'interfaccia IPropertySetStorage per creare o aprire un set di proprietà persistente. Un'istanza dell'interfaccia IPropertySetStorage può gestire zero o più istanze IPropertyStorage .

Ogni proprietà all'interno di un set di proprietà viene identificata da un identificatore di proprietà (ID), un valore ULONG a quattro byte univoco per tale set. È anche possibile assegnare un nome stringa a una proprietà tramite l'interfaccia IPropertyStorage .

Gli ID proprietà differiscono dagli ID di invio usati nei tag dei nomi delle proprietà dispid di Automazione. Una differenza è che l'uso generico dei valori ID proprietà zero e uno è vietato in IPropertyStorage, mentre non esiste alcuna restrizione in IDispatch. Inoltre, mentre è presente una sovrapposizione significativa tra i tipi di dati per i valori delle proprietà che possono essere usati in IPropertyStorage e IDispatch, i set di proprietà non sono identici. I tipi di dati delle proprietà persistenti usati nei metodi IPropertyStorage sono definiti nella struttura PROPVARIANT .

L'interfaccia IPropertyStorage può essere usata per accedere a set di proprietà semplici e non semplici. I set di proprietà non semplici possono contenere diversi tipi di proprietà complessi che non possono essere mantenuti in un set di proprietà semplice. Per altre informazioni, vedere Archiviazione e Stream oggetti per un set di proprietà.

Ereditarietà

L'interfaccia IPropertyStorage eredita dall'interfaccia IUnknown . IPropertyStorage include anche questi tipi di membri:

Metodi

L'interfaccia IPropertyStorage include questi metodi.


IPropertyStorage::Commit Il metodo IPropertyStorage::Commit salva le modifiche apportate a un oggetto di archiviazione delle proprietà nell'oggetto di archiviazione padre.
IPropertyStorage::D eleteMultiple Il metodo IPropertyStorage::D eleteMultiple elimina quante delle proprietà indicate esistono in un set di proprietà.
IPropertyStorage::D eletePropertyNames Il metodo IPropertyStorage::D eletePropertyNames elimina i nomi di stringa specificati dal set di proprietà corrente.
IPropertyStorage::Enum Il metodo IPropertyStorage::Enum crea un oggetto enumeratore progettato per enumerare i dati di tipo STATPROPSTG, che contiene informazioni sul set di proprietà corrente.
IPropertyStorage::ReadMultiple Il metodo IPropertyStorage::ReadMultiple legge le proprietà specificate dal set di proprietà corrente.
IPropertyStorage::ReadPropertyNames Il metodo IPropertyStorage::ReadPropertyNames recupera tutti i nomi di stringa esistenti per gli ID proprietà specificati.
IPropertyStorage::Revert Il metodo IPropertyStorage::Revert elimina tutte le modifiche apportate al set di proprietà denominato dall'ultima apertura o rimuove le modifiche che sono state eseguite per l'ultimo commit nel set di proprietà.
IPropertyStorage::SetClass Il metodo IPropertyStorage::SetClass assegna un nuovo CLSID all'oggetto di archiviazione delle proprietà corrente e archivia in modo permanente il CLSID con l'oggetto .
IPropertyStorage::SetTimes Il metodo IPropertyStorage::SetTimes imposta i tempi di modifica, accesso e creazione di questo set di proprietà, se supportato dall'implementazione.
IPropertyStorage::Stat Il metodo IPropertyStorage::Stat recupera informazioni sul set di proprietà open corrente. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple Il metodo IPropertyStorage::WriteMultiple scrive un gruppo specificato di proprietà nel set di proprietà corrente.
IPropertyStorage::WritePropertyNames Il metodo IPropertyStorage::WritePropertyNames assegna stringhe IPropertyStoragenames a una matrice specificata di ID proprietà nel set di proprietà corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	propidlbase.h (include Objbase.h, Propidlbase.h)