StrRetToBSTR 函数 (shlwapi.h)

接受 IShellFolder：：GetDisplayNameOf 返回的包含或指向字符串的 STRRET 结构，并将该字符串作为 BSTR 返回。

语法

LWSTDAPI StrRetToBSTR(
  [in, out] STRRET          *pstr,
  [in]      PCUITEMID_CHILD pidl,
  [out]     BSTR            *pbstr
);

[in, out] pstr

类型： STRRET*

指向 STRRET 结构的指针。当函数返回时，此指针的有效期更长。

[in] pidl

类型： PCUITEMID_CHILD

指向 ITEMIDLIST 的指针，该指针唯一标识相对于父文件夹的文件对象或子文件夹。此值可以为 NULL。

[out] pbstr

类型： BSTR*

指向类型为 BSTR 的变量的指针，该变量接收转换后的字符串。

类型： HRESULT

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

如果 pstr 指向的 STRRET 结构的 uType 成员设置为 STRRET_WSTR，则返回时释放该结构的 pOleStr 成员。