psGetPropertyValue 函数 (propsys.h)

从属性存储中获取属性值。

语法

PSSTDAPI PSGetPropertyValue(
  [in]  IPropertyStore       *pps,
  [in]  IPropertyDescription *ppd,
  [out] PROPVARIANT          *ppropvar
);

参数

[in] pps

类型： IPropertyStore*

指向 IPropertyStore 接口实例的指针，该接口表示要从中获取值的属性存储。

[in] ppd

类型： IPropertyDescription*

指向 IPropertyDescription 接口实例的指针，该接口表示属性存储中的属性。

[out] ppropvar

类型： PROPVARIANT*

指向未初始化的 PROPVARIANT 结构的指针。 当此函数返回时， 指向请求的属性值。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此帮助程序函数用于从存储区读取属性值。 如果调用代码已具有 PROPERTYKEY 结构，则直接调用 IPropertyStore：：GetValue 可能更简单。

示例

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

// IPropertyDescription *pPropDesc;
// IPropertyStore *pStore;
// Assume the variables pPropDesc and pStore are initialized and valid.
PROPVARIANT propvar;

HRESULT hr = PSGetPropertyValue(pStore, pPropDesc, &propvar);

if (SUCCEEDED(hr))
{
    // propvar is valid.
 
    PropVariantClear(&propvar);
}

要求

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

另请参阅

PSSetPropertyValue