Функция ILCreateFromPathW (shlobj_core.h)
Возвращает структуру ITEMIDLIST, связанную с указанным путем к файлу.
Синтаксис
PIDLIST_ABSOLUTE ILCreateFromPathW(
[in] PCWSTR 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) |