PSPropertyBag_ReadStr 函数 (propsys.h)

读取属性包中属性的字符串数据值。

语法

PSSTDAPI PSPropertyBag_ReadStr(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LPWSTR       value,
  [out] int          characterCount
);

参数

[in] propBag

类型： IPropertyBag*

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

[in] propName

类型： LPCWSTR

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

[out] value

类型： LPCWSTR

此函数返回时，包含指向字符串属性值的指针。

[out] characterCount

类型： int

此函数返回一个整数，该整数表示返回 的值 参数) 最大字符数 (大小。

返回值

类型： HRESULT

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

注解

属性包属性函数 API 在窗口类型和用于表示属性包中的值的 VARIANT 类型之间进行转换。 这样做可简化属性包的使用、简化应用程序并避免常见的编码错误。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	propsys.h
Library	Propsys.lib
DLL	Propsys.dll (版本 6.0 或更高版本)

另请参阅

PSPropertyBag_WriteStr