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

Статья
11/20/2024

Возвращает структуру ITEMIDLIST, связанную с указанным путем к файлу.

Синтаксис

PIDLIST_ABSOLUTE ILCreateFromPathA(
  [in] PCSTR pszPath
);

Параметры

[in] pszPath

Тип: PCTSTR

Указатель на строку Юникода, завершающую значение NULL, содержащую путь. Эта строка не должна превышать MAX_PATH символов длиной, включая завершающий символ NULL.

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

Тип: PIDLIST_ABSOLUTE

Возвращает указатель на структуру ITEMIDLIST, соответствующую пути.

Замечания

Вызовите ILFree, чтобы освободить ITEMIDLIST после завершения работы с ним.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj_core.h (include Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя версия)
набор API	ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)

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