PSPropertyBag_ReadStream函数 (propsys.h)

读取存储在指定属性包中包含的给定属性中的数据流。

语法

PSSTDAPI PSPropertyBag_ReadStream(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] IStream      **value
);

参数

[in] propBag

类型： IPropertyBag*

指向 IPropertyBag 对象的指针，该对象表示存储属性的属性包。

[in] propName

类型： LPCWSTR

指向以 null 结尾的属性名称字符串的指针。

[out] value

类型： IStream**

此函数成功返回时接收 IStream 对象的指针的地址。

返回值

类型： HRESULT

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

注解

PSPropertyBag_ReadStream 函数的调用方需要对此函数返回的 IStream 对象调用 IUnknown：：Release 方法。

IPropertyBag 和 IPersistPropertyBag 优化了“另存为文本”功能。 IPropertyBag 和 IPropertyBag2 为对象提供了一个属性包，对象可以在其中持久保存其属性。 IPropertyBag2 允许对象获取每个属性的类型信息： IPropertyBag2：：Read 会导致从属性包中读取一个或多个属性， 而 IPropertyBag2：：Write 会导致一个或多个属性保存到属性包中。

要求

另请参阅

PSPropertyBag_WriteStream