PSGetPropertyDescriptionListFromString 函数 (propsys.h)

获取指定属性列表的属性说明列表接口的实例。

语法

PSSTDAPI PSGetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

参数

[in] pszPropList

类型： LPCWSTR

指向以 null 结尾的 Unicode 字符串的指针，该字符串标识属性列表。 有关此参数的格式的详细信息，请参阅 IPropertySystem：：GetPropertyDescriptionListFromString 。

[in] riid

类型： REFIID

对所请求接口的接口 ID 的引用。

[out] ppv

类型： void**

当此函数返回时，包含 riid 中请求的接口指针。 这通常是 IPropertyDescriptionList。

返回值

类型： PSSTDAPI

返回以下值之一。

返回代码	说明
S_OK	已获取接口。
E_INVALIDARG	ppv 参数为 NULL。

注解

此函数调用 IPropertySystem：：GetPropertyDescriptionListFromString 的属性子系统实现，以获取作为分号分隔的属性列表字符串提供的属性集合。

建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏来打包 riid 和 ppv 参数。 此宏基于 ppv 中值指向的接口提供正确的 IID，这消除了编码错误的可能性。

有关属性架构的详细信息，请参阅 属性架构。

示例

以下示例将作为较大程序的一部分包含，演示如何使用 PSGetPropertyDescriptionListFromString。

IPropertyDescriptionList *pList;

HRESULT hr = PSGetPropertyDescriptionListFromString(L"prop:System.Title;System.Size",
                                                    IID_PPV_ARGS(&pList));
                                                    
if (SUCCEEDED(hr))
{
    // pList is now valid.
 
    pList->Release();
}

要求

要求	值
最低受支持的客户端	Windows XP SP2、Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 SP1 [仅限桌面应用]
目标平台	Windows
标头	propsys.h
Library	Propsys.lib
DLL	Propsys.dll (5.0 或更高版本)
可再发行组件	Windows 桌面搜索 (WDS) 3.0