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

[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 .

Требования

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

SHGetSpecialFolderPath