PSPropertyBag_ReadStrAlloc 函数 (propsys.h)

从属性包中的属性读取字符串数据值，并为读取的字符串分配内存。

语法

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *value
);

[in] propBag

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

[in] propName

类型： LPCWSTR

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

[out] value

类型： PWSTR*

当此函数返回时，包含指向属性包中某个属性的字符串数据值的指针，并为读取的字符串分配内存。 PSPropertyBag_ReadStrAlloc函数的调用方需要对此参数调用 CoTaskMemFree 函数。

类型： HRESULT

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

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