
IPropertyStore interface
Exposes methods for enumerating, getting, and setting property values.
Members
The IPropertyStore interface inherits from the IUnknown interface. IPropertyStore also has these types of members:
Methods
The IPropertyStore interface has these methods.
Method | Description |
---|---|
Commit |
Saves a property change. |
GetAt |
Gets a property key from an item's array of properties. |
GetCount |
Gets the number of properties attached to the file. |
GetValue |
Gets data for a specific property. |
SetValue |
Sets a new property value, or replaces or removes an existing value. |
Remarks
These methods can be called at any time after initialization of the property handler but before property changes are written to the file through IPropertyStore::Commit. At any other time, these methods return E_FAIL.
When to Implement
An implementation of this interface is provided by CLSID_InMemoryPropertyStore, as IPropertyStoreCache. Users should never need to implement it themselves.
CLSID_InMemoryPropertyStore implements IPropertyStoreCache instead of IPropertyStore so that it can store additional state information (PSC_STATE) about each of the properties in the cache. This information can be useful for property handler implementers. It can also be useful in other scenarios where a cache of property values is needed.
Requirements
Minimum supported client |
Windows Vista [desktop apps | UWP apps] |
---|---|
Minimum supported server |
Windows Server 2008 [desktop apps | UWP apps] |
Header |
|
IDL |
|