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

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

  • Статья

[SHILCreateFromPath доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого приложения должны использовать SHParseDisplayName ]

Создает указатель на список идентификаторов элементов (PIDL) из пути.

Синтаксис

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Параметры

[in] pszPath

Тип: PCWSTR

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

[out] ppidl

Тип: PIDLIST_ABSOLUTE*

Путь в pszPath , выраженный в виде PIDL.

[in, out, optional] rgfInOut

Тип: DWORD*

Указатель на значение DWORD , которое в записи указывает все атрибуты папки с именем в pszPath , которую вызывающее приложение хотело бы получить вместе с PIDL. При выходе это значение содержит запрашиваемые атрибуты. Список возможных флагов атрибутов для этого параметра см. в разделе IShellFolder::GetAttributesOf.

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

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

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