---
name: "StrRetToBSTR"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/StrRetToBSTR"
---

# StrRetToBSTR(3w)

## NAME

**StrRetToBSTR** (SHLWAPI.@)

## SYNOPSIS

HRESULT StrRetToBSTR\
  (\
   STRRET\*       *lpStrRet*,\
   LPCITEMIDLIST *pidl*,\
   BSTR\*         *pBstrOut*\
  )

## DESCRIPTION

Converts a **STRRET** to a **BSTR**.

## PARAMS

*lpStrRet* **\[Out\]**  **STRRET** to convert.

*pidl* **\[In\]**  **ITEMIDLIST** for *lpStrRet-\>uType* = **STRRET\_OFFSET**.

*pBstrOut* **\[Out\]**  Destination for converted **BSTR**.

## RETURNS

**Success:** **S\_OK**. *pBstrOut* contains the new string.

**Failure:** **E\_FAIL**, if any parameters are invalid.

## IMPLEMENTATION

Declared in **"shlwapi.h"**.

Implemented in **"dlls/shlwapi/string.c"**.

Debug channel **"shell"**.