Interfaccia IPropertyStorage (propidl.h)

Articolo
03/01/2024

L'interfaccia IPropertyStorage gestisce le proprietà permanenti 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 a Controlli e Automazione, che possono essere usate per influire sul comportamento del sistema. Utilizzare 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à è 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 di proprietà differiscono dagli ID dispatch 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 tale restrizione in IDispatch. Inoltre, sebbene si verifichi una sovrapposizione significativa tra i tipi di dati per i valori di proprietà che possono essere usati in IPropertyStorage e IDispatch, i set di proprietà non sono identici. I tipi di dati delle proprietà persistenti utilizzati nei metodi IPropertyStorage sono definiti nella struttura PROPVARIANT .

L'interfaccia IPropertyStorage può essere usata per accedere a set di proprietà semplici e nonsimple. I set di proprietà nonsimple 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 dispone di 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 tutte le proprietà indicate presenti in questo set di proprietà.
IPropertyStorage::D eletePropertyNames Il metodo DeletePropertyNames elimina i nomi di stringa specificati dal set di proprietà corrente. (IPropertyStorage.DeletePropertyNames)
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 di 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 di cui è stato eseguito 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à aperto 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 di 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	propidl.h (include Objbase.h, Propidlbase.h)