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 |