Share via

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

  • Статья

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

Извлекает указатель на структуру ITEMIDLIST , задающую специальную папку.

Синтаксис

PIDLIST_ABSOLUTE SHCloneSpecialIDList(
       HWND hwnd,
  [in] int  csidl,
  [in] BOOL fCreate
);

Параметры

hwnd

Тип: HWND

Зарезервировано.

[in] csidl

Тип: int

Значение CSIDL , определяющее интересующую папку.

[in] fCreate

Тип: BOOL

Значение типа BOOL , указывающее, следует ли создать папку, если она еще не существует. Если параметр fCreate имеет значение TRUE, создается папка. Если задано значение FALSE, папка не создается.

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

Тип: PIDLIST_ABSOLUTE

Возвращает указатель на структуру ITEMIDLIST специальной папки, заданной csidl. Функция создает папку, если fCreate имеет значение TRUE.

Комментарии

По завершении необходимо освободить указатель на клонированную папку с помощью ILFree.

Требования

Требование Значение
Минимальная версия клиента 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-2 (представлено в Windows 10 версии 10.0.14393)