IPropertyStoreCapabilities interface (propsys.h)

Exposes a method that determines whether a property can be edited in the UI by the user.

Inheritance

The IPropertyStoreCapabilities interface inherits from the IUnknown interface. IPropertyStoreCapabilities also has these types of members:

Methods

The IPropertyStoreCapabilities interface has these methods.

 
IPropertyStoreCapabilities::IsPropertyWritable

Queries whether the property handler allows a specific property to be edited in the UI by the user.

Remarks

When to Implement

Property handlers implement this interface to disable a user's ability to edit specific properties. These properties are typically editable in the UI, but are not supported for writing by the property handler. For example, the property System.Author is typically editable. If a property handler author created a file type that exposed System.Author for reading, but could not support writing this property back, the handler author could return S_FALSE from IPropertyStoreCapabilities::IsPropertyWritable for System.Author.

The Shell user interfaces that allow property editing, such as the Details Pane and Details Tab of the Properties dialog, call this method as part of determining whether to allow editing of a specific property. This allows the Shell property editing UI to disable controls rather than showing errors when the property handler fails to set or commit the property value.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header propsys.h