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

Статья
03/05/2024

[SHGetSpecialFolderLocation не поддерживается и может быть изменен или недоступен в будущем. Вместо этого используйте SHGetFolderLocation.]

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

Синтаксис

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Параметры

[in] hwnd

Тип: HWND

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

[in] csidl

Тип: int

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

[out] ppidl

Тип: PIDLIST_ABSOLUTE*

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

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

Тип: HRESULT

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

Требования

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

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

SHGetSpecialFolderPath

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