Función StrRetToStrN

Toma una estructura STRRET devuelta por IShellFolder::GetDisplayNameOf, la convierte en una cadena y coloca el resultado en un búfer.

Sintaxis

BOOL StrRetToStrN(
  _Out_   LPTSTR        pszOut,
  _In_    UINT          cchOut,
  _Inout_ LPSTRRET      pStrRet,
  _In_    LPCITEMIDLIST pidl
);

Parámetros

pszOut [out]

Tipo: LPTSTR

Búfer que contiene el nombre para mostrar. Se devolverá como una cadena terminada en null. Si cchOut es demasiado pequeño, el nombre se truncará para ajustarse.

cchOut [in]

Tipo: UINT

Tamaño de pszOut, en caracteres. Si cchOut es demasiado pequeño, la cadena se truncará para ajustarse.

pStrRet [in, out]

Tipo: LPSTRRET

Puntero a una estructura STRRET . Cuando la función vuelve, este puntero ya no será válido.

pidl [in]

Tipo: LPCITEMIDLIST

Puntero a la estructura ITEMIDLIST del elemento.

Valor devuelto

Tipo: BOOL

TRUE para que se complete correctamente, FALSE en caso de error.

Comentarios

Nota

A partir de Shell32.dll versión 5.0, llamar a esta función equivale a llamar a StrRetToBuf.

 

StrRetToStrN no se exporta por nombre. Para usarlo, debe usar GetProcAddress y solicitar ordinal 96 desde Shell32.dll para obtener un puntero de función.

Si el miembro uType de la estructura a la que apunta pStrRet se establece en STRRET_WSTR, el miembro pOleStr de esa estructura se liberará de vuelta.

Tenga en cuenta que esta función se exporta desde Shell32.dll en lugar de Shlwapi.dll. También se incluye en Shlobj.h en lugar de Shlwapi.h.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Archivo DLL	Shell32.dll (versión 4.71 o posterior)

Consulte también

StrRetToStr

StrRetToBuf