获取实现 IPropertyDescriptionList 的子系统对象的实例，以基于提供的字符串获取属性说明的有序集合。
语法
HRESULT GetPropertyDescriptionListFromString(
[in] LPCWSTR pszPropList,
[in] REFIID riid,
[out] void **ppv
);
参数
[in] pszPropList
类型： LPCWSTR
指向标识属性列表的字符串的指针。
[in] riid
类型： REFIID
对所需 IID 的引用。
[out] ppv
类型： void**
IPropertyDescriptionList 接口指针的地址。
返回值
类型： HRESULT
返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
指示已获取接口。 |
|
指示 ppv 为 NULL。 |
注解
属性说明列表字符串 (“proplist”) 语法包含一系列规范属性名称，以及与每个属性名称关联的标志。 字符串以“prop：”开头。 语法如下所示： prop:[flags]propertyname[endflags];
标志是可选的，可以是以下任一标志。 注意：这些标志转换为 PROPDESC_VIEW_FLAGS 枚举。
| 标志 | 含义 |
|---|---|
| - | (PDVF_REVERSESORT) 按相反顺序排序。 |
| 0 | 默认在主列表和辅助列表中显示 (PDVF_SHOWBYDEFAULT |PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST) 。 |
| 1 | 在主列表和辅助列表中显示 (PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST) 。 |
| 2 | 在辅助列表 (PDVF_SHOWINSECONDARYLIST) 中显示。 |
| ^ | 开始 (PDVF_BEGINNEWGROUP) 新组。 |
| / | 右对齐 (PDVF_RIGHTALIGN) 。 |
| * | 如果值不存在，则隐藏。 |
| | | 居中对齐。 (PDVF_CENTERALIGN) 。 |
| ~ | 隐藏标签。 (PDVF_HIDELABEL) 。 |
| # | 填充区域。 (PDVF_FILLAREA) 。 |
| ? | 如果属性处理程序 (PDVF_HIDEIFUNSUPPORTED) 不支持，则隐藏。 |
| < | 分析为链接 (PDVF_PARSEASLINK) 。 |
| & | 显示为整个链接 (PDVF_SHOWASWHOLELINK) 。 |
从 dbfolder 和 file folder 的角度来看：
| 0 | 在 defview、列选择器菜单和列选择器对话框中显示为列。 |
| 1 | 在列选择器菜单和对话框中显示。 |
| 2 | 在列选择器对话框中显示。 |
| NULL | 包含在搜索结果中，但在 UI 中隐藏。 |
尾标志也是可选的，可以是以下内容：
| EndFlag | 含义 |
|---|---|
| ] | 用于扩展磁贴视图) 的结束列 (。 |
建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏打包 riid 和 ppv 参数。 此宏基于 ppv 中的 值指向的接口提供正确的 IID，消除了编码错误的可能性。
有关属性架构的详细信息，请参阅 属性架构。
要求
| 最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | propsys.h |
| DLL | Propsys.dll (5.0 或更高版本) |
| 可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |