psSetPropertyValue 函数 (propsys.h)
设置属性存储区中属性的值。
语法
PSSTDAPI PSSetPropertyValue(
[in] IPropertyStore *pps,
[in] IPropertyDescription *ppd,
[in] REFPROPVARIANT propvar
);
参数
[in] pps
类型： IPropertyStore*
指向 IPropertyStore 接口实例的指针，该接口表示包含属性的属性存储区。
[in] ppd
类型： IPropertyDescription*
指向 IPropertyDescription 接口实例的指针，该接口标识单个属性。
[in] propvar
类型： REFPROPVARIANT
对包含新值的 PROPVARIANT 结构的引用。
返回值
类型： HRESULT
如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
注解
此帮助程序函数用于将属性值写入存储区。 如果调用代码已具有 PROPERTYKEY 结构，则直接调用 IPropertyStore：：SetValue 可能更简单。
示例
以下示例将作为较大程序的一部分包含，演示如何使用 PSSetPropertyValue。
// IPropertyDescription *pPropDesc;
// IPropertyStore *pStore;
// PROPVARIANT propvar;
// Assume the variables pStore, pPropDesc, and propvar are initialized and valid.
HRESULT hr = PSSetPropertyValue(pStore, pPropDesc, propvar);
if (SUCCEEDED(hr))
{
// The value has been written to the store but has not been committed yet.
}
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | propsys.h |
| Library | Propsys.lib |
| DLL | Propsys.dll (6.0 或更高版本) |
| 可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |