PSEnumeratePropertyDescriptions 函数 (propsys.h)

一个包装 API,用于调用架构子系统的 IPropertySystem::EnumeratePropertyDescriptions。 此函数检索实现 IPropertyDescriptionList 的子系统对象的实例,以获取系统中属性说明的整个列表或部分列表。

语法

PSSTDAPI PSEnumeratePropertyDescriptions(
  [in]  PROPDESC_ENUMFILTER filterOn,
  [in]  REFIID              riid,
  [out] void                **ppv
);

参数

[in] filterOn

类型: PROPDESC_ENUMFILTER

要返回的列表。 PROPDESC_ENUMFILTER 显示此方法的有效值。

[in] riid

类型: REFIID

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

[out] ppv

类型: void**

IPropertyDescriptionList 接口指针的地址。

返回值

类型: PSSTDAPI

返回以下值之一。

返回代码 说明
S_OK
指示已获取接口。
E_INVALIDARG
指示 ppvNULL

注解

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

要求

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