IPropertySystem：：GetPropertyDescriptionListFromString 方法 (propsys.h)

获取实现 IPropertyDescriptionList 的子系统对象的实例，以基于提供的字符串获取属性说明的有序集合。

语法

HRESULT GetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

[in] pszPropList

类型： LPCWSTR

指向标识属性列表的字符串的指针。

[in] riid

类型： REFIID

对所需 IID 的引用。

[out] ppv

类型： void**

IPropertyDescriptionList 接口指针的地址。

类型： HRESULT

返回以下值之一。

返回代码	说明
S_OK	指示已获取接口。
E_INVALIDARG	指示 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