Функция SHGetNameFromIDList (shobjidl_core.h)

Извлекает отображаемое имя элемента, определяемого его IDList.

Синтаксис

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

Параметры

[in] pidl

Тип: PCIDLIST_ABSOLUTE

Идентификатор PIDL, идентифицирующий элемент.

[in] sigdnName

Тип: SIGDN

Значение из перечисления SIGDN , указывающее тип извлекаемого отображаемого имени.

[out] ppszName

Тип: PWSTR*

Значение , которое при успешном возврате этой функции получает адрес указателя на полученное отображаемое имя.

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Вызывающий объект отвечает за освобождение строки, на которую указывает ppszName , когда она больше не нужна. Вызовите CoTaskMemFree для *ppszName , чтобы освободить память.

Требования