Compartir a través de

Función StrRetToBSTR (shlwapi.h)

  • Artículo

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

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.5 o posterior)

Consulte también

IShellFolder::GetDisplayNameOf

StrRetToBuf

StrRetToStr