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

[SHGetSpecialFolderPath не поддерживается. Вместо этого используйте SHGetFolderPath.]

Извлекает путь к специальной папке, определяемой по CSIDL.

Синтаксис

BOOL SHGetSpecialFolderPathA(
        HWND  hwnd,
  [out] LPSTR pszPath,
  [in]  int   csidl,
  [in]  BOOL  fCreate
);

Параметры

hwnd

Тип: HWND

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

[out] pszPath

Тип: LPTSTR

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

[in] csidl

Тип: int

CSIDL, определяющий интересующую папку. Если указана виртуальная папка, эта функция завершится ошибкой.

[in] fCreate

Тип: BOOL

Указывает, следует ли создать папку, если она еще не существует. Если это ненулевое значение, создается папка. Если это значение равно нулю, папка не создается.

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

Тип: BOOL

Значение TRUE в случае успешного выполнения; в противном случае — FALSE.

Комментарии

Чтобы эта функция была доступна, необходимо установить обновление microsoft Internet Обозреватель 4.0 desktop.

Примечание

Заголовок shlobj_core.h определяет SHGetSpecialFolderPath в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h, Shlobj_core.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 4.71 или более поздняя)