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

另请参阅

IPropertyStore：：Commit

PSGetPropertyValue