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 会导致一个或多个属性保存到属性包中。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | propsys.h |
Library | Propsys.lib |
DLL | Propsys.dll (6.0 或更高版本) |