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

Статья
11/20/2024

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

Синтаксис

BOOL SHGetPathFromIDListW(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPWSTR            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 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj_core.h (include 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

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