IPropertySystem::GetPropertyDescriptionByName 方法 (propsys.h)

获取实现 IPropertyDescription 的子系统对象的实例,以获取给定规范名称的属性说明。

语法

HRESULT GetPropertyDescriptionByName(
  [in]  LPCWSTR pszCanonicalName,
  [in]  REFIID  riid,
  [out] void    **ppv
);

参数

[in] pszCanonicalName

类型: LPCWSTR

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

[in] riid

类型: REFIID

对所需 IID 的引用。

[out] ppv

类型: void**

IPropertyDescription 接口指针的地址。

返回值

类型: PSSTDAPI

返回以下值之一。

返回代码 说明
S_OK
指示获取接口。
E_INVALIDARG
指示 pszCanonicalNameNULL
TYPE_E_ELEMENTNOTFOUND
指示架构子系统缓存中不存在规范名称。

注解

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

要求

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

另请参阅

IPropertySystem