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

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

  • Статья

Преобразует список идентификаторов элементов в путь файловой системы. Эта функция расширяет SHGetPathFromIDList , позволяя задать начальный размер строкового буфера и объявить указанные ниже параметры.

Синтаксис

BOOL SHGetPathFromIDListEx(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] PWSTR             pszPath,
        DWORD             cchPath,
        GPFIDL_FLAGS      uOpts
);

Параметры

[in] pidl

Тип: PCIDLIST_ABSOLUTE

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

[out] pszPath

Тип: PWSTR

При вызове этой функции ей передается буфер Юникода, завершающийся нулевым значением, для получения пути к файловой системе. Этот буфер имеет размер cchPath.

При возврате этой функции содержит адрес завершаемого нулевым значением буфера Юникода, который содержит путь к файловой системе. Этот буфер имеет размер cchPath.

cchPath

Тип: DWORD

Размер буфера, на который указывает pszPath, в символах.

uOpts

Тип: GPFIDL_FLAGS

Эти флаги определяют тип возвращаемого пути.

GPFIDL_DEFAULT (0x0000)

Включены имена файлов Win32, серверов и корневых дисков.

GPFIDL_ALTNAME (0x0001)

Использует короткие имена файлов.

GPFIDL_UNCPRINTER (0x0002)

Включите элементы имен UNC-принтеров.

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

Тип: BOOL

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

Комментарии

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

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

Требования

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

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

SHParseDisplayName