IPropertySystem interface
Exposes methods that get property descriptions, register and unregister property schemas, enumerate property descriptions, and format property values in a type-strict way.
Members
The IPropertySystem interface inherits from the IUnknown interface. IPropertySystem also has these types of members:
Methods
The IPropertySystem interface has these methods.
| Method | Description |
|---|---|
| EnumeratePropertyDescriptions |
Gets an instance of the subsystem object that implements IPropertyDescriptionList, to obtain either the entire or a partial list of property descriptions in the system. |
| FormatForDisplay |
Gets a formatted, Unicode string representation of a property value. |
| FormatForDisplayAlloc |
Gets a string representation of a property value to an allocated memory buffer. |
| GetPropertyDescription |
Gets an instance of the subsystem object that implements IPropertyDescription, to obtain the property description for a given PROPERTYKEY. |
| GetPropertyDescriptionByName |
Gets an instance of the subsystem object that implements IPropertyDescription, to obtain the property description for a given canonical name. |
| GetPropertyDescriptionListFromString |
Gets an instance of the subsystem object that implements IPropertyDescriptionList, to obtain an ordered collection of property descriptions, based on the provided string. |
| RefreshPropertySchema |
Not currently supported. |
| RegisterPropertySchema |
Informs the schema subsystem of the addition of a property description schema file. |
| UnregisterPropertySchema |
Informs the schema subsystem of the removal of a property description schema (.propdesc) file, using a file path to the .propdesc file on the local machine. |
Remarks
Many of the exported APIs (such as PSGetPropertyDescription) are simply wrappers around the IPropertySystem methods. If your code calls a lot of these helper APIs in sequence, it may be worthwhile to instantiate a single IPropertySystem object, and call the methods directly, rather than calling the helper APIs. (To improve the performance, the helper APIs do obtain a cached instance of the IPropertySystem object.)
Requirements
|
Minimum supported client |
Windows XP with SP2, Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 with SP1 [desktop apps only] |
|
Redistributable |
Windows Desktop Search (WDS) 3.0 |
|
Header |
|
|
IDL |
|