PSPropertyBag_ReadType 函数 (propsys.h)
读取存储在属性包中的属性的数据值的类型。
语法
PSSTDAPI PSPropertyBag_ReadType(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] VARIANT *var,
[out] VARTYPE type
);
parameters
[in] propBag
类型: IPropertyBag*
指向 IPropertyBag 对象的指针,该对象表示存储属性的属性包。
[in] propName
类型: LPCWSTR
指向以 null 结尾的属性名称字符串的指针。
[out] var
类型: VARIANT*
函数成功完成后,返回指向包含属性值的 VARIANT 数据类型的指针。
[out] type
类型: VARTYPE*
如果 type 为VT_EMPTY,则此函数读取 IPropertyBag propBag 参数中 属性的 VARIANT。 如果 type 不VT_EMPTY且与 VARIANT 读取不同,则此函数在返回之前尝试将 VARIANT 读取转换为由类型参数定义的 VARTYPE。
返回值
类型: HRESULT
如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
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 或更高版本) |