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 成員。