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


CSIDL

Примечание

В Windows Vista эти значения были заменены значениями KNOWNFOLDERID . Список новых констант и их соответствующих значений CSIDL см. в этом разделе. Для удобства здесь также указаны соответствующие значения KNOWNFOLDERID для каждого значения CSIDL.

Система CSIDL поддерживается в Windows Vista для обеспечения совместимости. Однако новые разработки должны использовать значения KNOWNFOLDERID , а не значения CSIDL.

 

Значения CSIDL (постоянный специальный список идентификаторов элементов) предоставляют уникальный системный способ идентификации специальных папок, часто используемых приложениями, но которые могут иметь не то же имя или расположение в любой конкретной системе. Например, системная папка может быть "C:\Windows" в одной системе и "C:\Winnt" в другой. Эти константы определены в Shlobj.h.

Констант/значение Описание
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
Версия 5.0. Каталог файловой системы, используемый для хранения инструментов администрирования для отдельного пользователя. MMC сохранит настроенные консоли в этом каталоге и будет перемещаться вместе с пользователем.
CSIDL_ALTSTARTUP
FOLDERID_Startup
Каталог файловой системы, соответствующий нелокализованной группе программы запуска пользователя. Это значение распознается в Windows Vista для обеспечения обратной совместимости, но сама папка больше не существует.
CSIDL_APPDATA
FOLDERID_RoamingAppData
Версия 4.71. Каталог файловой системы, который служит общим репозиторием для данных конкретного приложения. Типичный путь — C:\Documents и Settings\username\Application Data.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
Виртуальная папка, содержащая объекты в корзине пользователя.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
Версия 6.0. Каталог файловой системы, выполняющий функции области промежуточного хранения для файлов, ожидающих записи на компакт-диск. Типичный путь — C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Версия 5.0. Каталог файловой системы, содержащий инструменты администрирования для всех пользователей компьютера.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
Каталог файловой системы, соответствующий нелокализованной группе программы запуска для всех пользователей. Это значение распознается в Windows Vista для обеспечения обратной совместимости, но сама папка больше не существует.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
Версия 5.0. Каталог файловой системы, содержащий данные приложения для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Application Data. Эта папка используется для данных приложения, которые не относятся к конкретному пользователю. Например, приложение может хранить словарь проверка орфографии, базу данных картинок или файл журнала в папке CSIDL_COMMON_APPDATA. Эта информация не перемещается и доступна всем пользователям компьютера.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
Каталог файловой системы, содержащий файлы и папки, отображающиеся на рабочих столах всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Desktop.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
Каталог файловой системы, содержащий документы, общие для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
Каталог файловой системы, который служит общим репозиторием для избранных элементов, общих для всех пользователей.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
Версия 6.0. Каталог файловой системы, служащий репозиторием музыкальных файлов, общих для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents\My Music.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Это значение распознается в Windows Vista для обеспечения обратной совместимости, но сама папка больше не используется.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
Версия 6.0. Каталог файловой системы, служащий репозиторием файлов изображений, общих для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents\My Pictures.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
Каталог файловой системы, содержащий каталоги для общих групп программ, которые отображаются в меню Пуск для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Start Menu\Programs.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
Каталог файловой системы, содержащий программы и папки, отображающиеся в меню Пуск для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Start Menu.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
Каталог файловой системы, содержащий программы и папки, отображающиеся в папке Автозагрузка для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Start Menu\Programs\Startup.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
Каталог файловой системы, содержащий шаблоны, доступные всем пользователям. Типичный путь — C:\Documents and Settings\All Users\Templates.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
Версия 6.0. Каталог файловой системы, служащий репозиторием файлов видеозаписей, общих для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents\My Videos.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
Папка, представляющая другие компьютеры в рабочей группе.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
Виртуальная папка, представляющая сетевые подключения, содержащая сетевые подключения и коммутируемые подключения.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
Виртуальная папка, содержащая значки для приложений панель управления.
CSIDL_COOKIES
FOLDERID_Cookies
Каталог файловой системы, который служит общим репозиторием для файлов cookie в Интернете. Типичный путь — C:\Documents and Settings\username\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
Виртуальная папка, представляющая рабочий стол Windows, корень пространства имен.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
Каталог файловой системы, используемый для физического хранения объектов файлов на рабочем столе (не следует путать с самой папкой рабочего стола). Типичный путь — C:\Documents and Settings\username\Desktop.
CSIDL_DRIVES
FOLDERID_ComputerFolder
Виртуальная папка , представляющая "Мой компьютер", содержащая все данные на локальном компьютере: запоминающие устройства, принтеры и панель управления. Папка также может содержать сопоставленные сетевые диски.
CSIDL_FAVORITES
FOLDERID_Favorites
Каталог файловой системы, который служит общим репозиторием для избранных элементов пользователя. Типичный путь — C:\Documents and Settings\username\Favorites.
CSIDL_FONTS
FOLDERID_Fonts
Виртуальная папка, содержащая шрифты. Типичный путь — C:\Windows\Fonts.
CSIDL_HISTORY
FOLDERID_History
Каталог файловой системы, который служит общим репозиторием для элементов журнала Интернета.
CSIDL_INTERNET
FOLDERID_InternetFolder
Виртуальная папка для интернет-Обозреватель.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
Версия 4.72. Каталог файловой системы, который служит общим репозиторием для временных файлов в Интернете. Типичный путь — C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
Версия 5.0. Каталог файловой системы, который служит репозиторием данных для локальных (некормированных) приложений. Типичный путь — C:\Documents and Settings\username\Local Settings\Application Data.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Версия 6.0. Виртуальная папка, представляющая элемент рабочего стола "Мои документы". Это значение эквивалентно CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
Каталог файловой системы, который служит общим репозиторием для музыкальных файлов. Типичный путь — C:\Documents and Settings\User\My Documents\My Music.
CSIDL_MYPICTURES
FOLDERID_Pictures
Версия 5.0. Каталог файловой системы, который служит общим репозиторием для файлов образов. Типичный путь — C:\Documents and Settings\username\My Documents\My Pictures.
CSIDL_MYVIDEO
FOLDERID_Videos
Версия 6.0. Каталог файловой системы, который служит общим репозиторием для видеофайлов. Типичный путь — C:\Documents and Settings\username\My Documents\My Videos.
CSIDL_NETHOOD
FOLDERID_NetHood
Каталог файловой системы, содержащий объекты ссылок, которые могут существовать в виртуальной папке Сетевое окружение. Это не то же самое, что CSIDL_NETWORK, представляющий корень сетевого пространства имен. Типичный путь — C:\Documents and Settings\username\NetHood.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Виртуальная папка, представляющая сетевое окружение, корень иерархии сетевого пространства имен.
CSIDL_PERSONAL
FOLDERID_Documents
Версия 6.0. Виртуальная папка, представляющая элемент рабочего стола "Мои документы". Это эквивалентно CSIDL_MYDOCUMENTS.
До версии 6.0. Каталог файловой системы, используемый для физического хранения общего репозитория документов пользователя. Типичный путь — C:\Documents and Settings\username\My Documents. Это следует отличать от виртуальной папки "Мои документы" в пространстве имен. Чтобы получить доступ к этой виртуальной папке, используйте SHGetFolderLocation, которая возвращает ITEMIDLIST для виртуального расположения, или обратитесь к методу, описанному в разделе Управление файловой системой.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
Виртуальная папка, содержащая установленные принтеры.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
Каталог файловой системы, содержащий объекты ссылок, которые могут существовать в виртуальной папке Принтеры. Типичный путь — C:\Documents and Settings\username\PrintHood.
CSIDL_PROFILE
FOLDERID_Profile
Версия 5.0. Папка профиля пользователя. Типичный путь — C:\Users\username. Приложения не должны создавать файлы или папки на этом уровне; они должны помещать свои данные в расположения, на которые ссылается CSIDL_APPDATA или CSIDL_LOCAL_APPDATA. Однако при создании новой известной папки корень профиля, на который ссылается CSIDL_PROFILE, подходит.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Версия 5.0. Папка Program Files. Типичный путь — C:\Program Files.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Версия 5.0. Папка для компонентов, совместно используемых несколькими приложениями. Типичный путь — C:\Program Files\Common. Допустимо только для Windows XP.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
Каталог файловой системы, содержащий группы программ пользователя (которые сами являются каталогами файловой системы). Типичный путь — C:\Documents and Settings\username\Start Menu\Programs.
CSIDL_RECENT
FOLDERID_Recent
Каталог файловой системы, содержащий ярлыки для последних использованных документов пользователя. Типичный путь — C:\Documents and Settings\username\My Recent Documents. Чтобы создать ярлык в этой папке, используйте SHAddToRecentDocs. Помимо создания ярлыка, эта функция обновляет список последних документов оболочки и добавляет ярлык в подменю Мои последние документы меню "Пуск ".
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista. Каталог файловой системы, содержащий данные ресурсов. Типичный путь — C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
Каталог файловой системы, содержащий пункты меню "Отправить ". Типичный путь — C:\Documents и Settings\username\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
Каталог файловой системы, содержащий элементы меню "Пуск ". Типичный путь — C:\Documents and Settings\username\Start Menu.
CSIDL_STARTUP
FOLDERID_Startup
Каталог файловой системы, соответствующий группе программы запуска пользователя. Система запускает эти программы при каждом входе связанного пользователя. Типичный путь — C:\Documents and Settings\username\Start Menu\Programs\Startup.
CSIDL_SYSTEM
FOLDERID_System
Версия 5.0. Папка System ОС Windows. Типичный путь — C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
Каталог файловой системы, который выступает в качестве общего репозитория для шаблонов документов. Типичный путь — C:\Documents и Settings\username\Templates.
CSIDL_WINDOWS
FOLDERID_Windows
Версия 5.0. Каталог Windows или SYSROOT. Это соответствует переменным среды %windir% и %SYSTEMROOT%. Типичный путь — C:\Windows.
Flags
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Версия 5.0. Объединение с другим CSIDL для принудительного создания связанной папки, если она не существует.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Объедините с другой константой CSIDL, чтобы обеспечить расширение переменных среды.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
Объедините с другой константой CSIDL, за исключением CSIDL_FLAG_CREATE, чтобы вернуть непроверенный путь к папке без попыток создания или инициализации папки.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
Объедините с другой константой CSIDL, чтобы гарантировать получение истинного системного пути к папке без каких-либо псевдонимов заполнителей, таких как %USERPROFILE%, возвращаемых SHGetFolderLocation. Этот флаг не влияет на пути, возвращаемые SHGetFolderPath.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
Маска для любого допустимого значения флага CSIDL.

Комментарии

Эти значения заменяют использование переменных среды для этой цели. Они, в свою очередь, заменяются в Windows Vista и более поздних версиях значениями KNOWNFOLDERID .

CSIDL используется в сочетании с одной из четырех функций оболочки SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation и SHGetSpecialFolderPath, чтобы получить путь к специальной папке или указатель на список идентификаторов элементов (PIDL).

Объедините CSIDL_FLAG_CREATE с любым другим CSIDL, за исключением CSIDL_FLAG_DONT_VERIFY, чтобы принудительно создать связанную папку. Остальные CSIDL соответствуют папкам файловой системы или виртуальным папкам. Если CSIDL идентифицирует папку файловой системы, в качестве примера приведен часто используемый путь. Могут использоваться и другие пути. Некоторые CSIDL можно сопоставить с эквивалентной переменной среды %VariableName%. Однако CSIDL являются более надежными, и их следует использовать по возможности.

Требования

Требование Значение
Заголовок
Shlobj.h

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

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG