Función StrRetToBSTR (shlwapi.h)

Acepta una estructura STRRET devuelta por IShellFolder::GetDisplayNameOf que contiene o apunta a una cadena y devuelve esa cadena como BSTR.

Sintaxis

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

Parámetros

[in, out] pstr

Tipo: STRRET*

Puntero a una estructura STRRET . Cuando la función devuelve, este puntero es más largo válido.

[in] pidl

Tipo: PCUITEMID_CHILD

Puntero a un ITEMIDLIST que identifica de forma única un objeto de archivo o una subcarpeta en relación con la carpeta primaria. Este valor puede ser NULL.

[out] pbstr

Tipo: BSTR*

Puntero a una variable de tipo BSTR que recibe la cadena convertida.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si el miembro uType de la estructura STRRET a la que apunta pstr se establece en STRRET_WSTR, el miembro pOleStr de esa estructura se libera a cambio.

Requisitos

Consulte también

IShellFolder::GetDisplayNameOf

StrRetToBuf

StrRetToStr