PSGetImageReferenceForValue 函数 (propsys.h)

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

语法

PSSTDAPI PSGetImageReferenceForValue(
  [in]  REFPROPERTYKEY propkey,
  [in]  REFPROPVARIANT propvar,
  [out] PWSTR          *ppszImageRes
);

[in] propkey

类型： REFPROPERTYKEY

对指定属性的 PROPERTYKEY 结构的引用。

[in] propvar

类型： REFIID

对要通过 ppv 检索的接口的 IID 的引用。

[out] ppszImageRes

类型： void**

当此函数成功返回时，包含 riid 中请求的接口指针。

类型： HRESULT

如果成功，则返回 S_OK ，否则返回错误值，包括：

返回代码	说明
TYPE_E_ELEMENTNOTFOUND

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