Функция SHGetPathFromIDListA (shlobj_core.h)

Преобразует список идентификаторов элементов в путь файловой системы.

Синтаксис

BOOL SHGetPathFromIDListA(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPSTR             pszPath
);

Параметры

[in] pidl

Тип: PCIDLIST_ABSOLUTE

Адрес списка идентификаторов элементов, указывающий расположение файла или каталога относительно корня пространства имен (рабочего стола).

[out] pszPath

Тип: LPTSTR

Адрес буфера для получения пути к файловой системе. Размер этого буфера должен быть не менее MAX_PATH символов.

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

Тип: BOOL

Возвращает значение TRUE при успешном выполнении; в противном случае — FALSE.

Комментарии

Если расположение, указанное параметром pidl , не является частью файловой системы, эта функция завершится ошибкой.

Если параметр pidl указывает ярлык, pszPath будет содержать путь к ярлыку, а не к целевому элементу ярлыка.

Примечание

Заголовок shlobj_core.h определяет SHGetPathFromIDList в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h, Shlobj_core.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 4.0 или более поздняя)
Набор API	ext-ms-win-shell-shell32-l1-2-2 (представлено в Windows 10 версии 10.0.14393)

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

SHGetPathFromIDListEx

SHParseDisplayName