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

Статья
11/20/2024

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

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

Синтаксис

BOOL SHGetSpecialFolderPathW(
        HWND   hwnd,
  [out] LPWSTR 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 Explorer 4.0.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj_core.h (include Shlobj.h, Shlobj_core.h)
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 4.71 или более поздняя)

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