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

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

Синтаксис

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 , чтобы освободить память.

Требования