Поделиться через

Функция StrRetToStrN

  • Статья

Принимает структуру STRRET , возвращенную IShellFolder::GetDisplayNameOf, преобразует ее в строку и помещает результат в буфер.

Синтаксис

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

Параметры

pszOut [out]

Тип: LPTSTR

Буфер для хранения отображаемого имени. Он будет возвращен в виде строки, заканчивающейся нулевым значением. Если параметр cchOut слишком мал, имя будет усечено по размеру.

cchOut [in]

Тип: UINT

Размер pszOut в символах. Если параметр cchOut слишком мал, строка будет усечена в соответствии с размером.

pStrRet [in, out]

Тип: LPSTRRET

Указатель на структуру STRRET . Когда функция возвращает значение , этот указатель больше не будет допустимым.

pidl [in]

Тип: LPCITEMIDLIST

Указатель на структуру ITEMIDLIST элемента.

Возвращаемое значение

Тип: BOOL

Значение TRUE — успешное выполнение, FALSE — неудача.

Комментарии

Примечание

Начиная с Shell32.dll версии 5.0 вызов этой функции эквивалентен вызову StrRetToBuf.

 

StrRetToStrN не экспортируется по имени. Чтобы использовать его, необходимо использовать GetProcAddress и запросить порядковый номер 96 из Shell32.dll, чтобы получить указатель функции.

Если элемент uType структуры, на который указывает pStrRet , имеет значение STRRET_WSTR, элемент pOleStr этой структуры будет освобожден при возврате.

Обратите внимание, что эта функция экспортируется из Shell32.dll, а не из Shlwapi.dll. Он также включен в Shlobj.h, а не Shlwapi.h.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
DLL
Shell32.dll (версия 4.71 или более поздняя)

См. также раздел

StrRetToStr

StrRetToBuf