CSIDL
Примечание
В Windows Vista эти значения были заменены значениями KNOWNFOLDERID . Список новых констант и их соответствующих значений CSIDL см. в этом разделе. Для удобства здесь также указаны соответствующие значения KNOWNFOLDERID для каждого значения CSIDL.
Система CSIDL поддерживается в Windows Vista для обеспечения совместимости. Однако новые разработки должны использовать значения KNOWNFOLDERID , а не значения CSIDL.
Значения CSIDL (постоянный специальный список идентификаторов элементов) предоставляют уникальный системный способ идентификации специальных папок, часто используемых приложениями, но которые могут иметь не то же имя или расположение в любой конкретной системе. Например, системная папка может быть "C:\Windows" в одной системе и "C:\Winnt" в другой. Эти константы определены в Shlobj.h.
| Констант/значение | Описание |
|---|---|
|
Версия 5.0. Каталог файловой системы, используемый для хранения инструментов администрирования для отдельного пользователя. MMC сохранит настроенные консоли в этом каталоге и будет перемещаться вместе с пользователем. |
|
Каталог файловой системы, соответствующий нелокализованной группе программы запуска пользователя. Это значение распознается в Windows Vista для обеспечения обратной совместимости, но сама папка больше не существует. |
|
Версия 4.71. Каталог файловой системы, который служит общим репозиторием для данных конкретного приложения. Типичный путь — C:\Documents и Settings\username\Application Data. |
|
Виртуальная папка, содержащая объекты в корзине пользователя. |
|
Версия 6.0. Каталог файловой системы, выполняющий функции области промежуточного хранения для файлов, ожидающих записи на компакт-диск. Типичный путь — C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning. |
|
Версия 5.0. Каталог файловой системы, содержащий инструменты администрирования для всех пользователей компьютера. |
|
Каталог файловой системы, соответствующий нелокализованной группе программы запуска для всех пользователей. Это значение распознается в Windows Vista для обеспечения обратной совместимости, но сама папка больше не существует. |
|
Версия 5.0. Каталог файловой системы, содержащий данные приложения для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Application Data. Эта папка используется для данных приложения, которые не относятся к конкретному пользователю. Например, приложение может хранить словарь проверка орфографии, базу данных картинок или файл журнала в папке CSIDL_COMMON_APPDATA. Эта информация не перемещается и доступна всем пользователям компьютера. |
|
Каталог файловой системы, содержащий файлы и папки, отображающиеся на рабочих столах всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Desktop. |
|
Каталог файловой системы, содержащий документы, общие для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents. |
|
Каталог файловой системы, который служит общим репозиторием для избранных элементов, общих для всех пользователей. |
|
Версия 6.0. Каталог файловой системы, служащий репозиторием музыкальных файлов, общих для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents\My Music. |
|
Это значение распознается в Windows Vista для обеспечения обратной совместимости, но сама папка больше не используется. |
|
Версия 6.0. Каталог файловой системы, служащий репозиторием файлов изображений, общих для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents\My Pictures. |
|
Каталог файловой системы, содержащий каталоги для общих групп программ, которые отображаются в меню Пуск для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Start Menu\Programs. |
|
Каталог файловой системы, содержащий программы и папки, отображающиеся в меню Пуск для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Start Menu. |
|
Каталог файловой системы, содержащий программы и папки, отображающиеся в папке Автозагрузка для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Start Menu\Programs\Startup. |
|
Каталог файловой системы, содержащий шаблоны, доступные всем пользователям. Типичный путь — C:\Documents and Settings\All Users\Templates. |
|
Версия 6.0. Каталог файловой системы, служащий репозиторием файлов видеозаписей, общих для всех пользователей. Типичный путь — C:\Documents and Settings\All Users\Documents\My Videos. |
|
Папка, представляющая другие компьютеры в рабочей группе. |
|
Виртуальная папка, представляющая сетевые подключения, содержащая сетевые подключения и коммутируемые подключения. |
|
Виртуальная папка, содержащая значки для приложений панель управления. |
|
Каталог файловой системы, который служит общим репозиторием для файлов cookie в Интернете. Типичный путь — C:\Documents and Settings\username\Cookies. |
|
Виртуальная папка, представляющая рабочий стол Windows, корень пространства имен. |
|
Каталог файловой системы, используемый для физического хранения объектов файлов на рабочем столе (не следует путать с самой папкой рабочего стола). Типичный путь — C:\Documents and Settings\username\Desktop. |
|
Виртуальная папка , представляющая "Мой компьютер", содержащая все данные на локальном компьютере: запоминающие устройства, принтеры и панель управления. Папка также может содержать сопоставленные сетевые диски. |
|
Каталог файловой системы, который служит общим репозиторием для избранных элементов пользователя. Типичный путь — C:\Documents and Settings\username\Favorites. |
|
Виртуальная папка, содержащая шрифты. Типичный путь — C:\Windows\Fonts. |
|
Каталог файловой системы, который служит общим репозиторием для элементов журнала Интернета. |
|
Виртуальная папка для интернет-Обозреватель. |
|
Версия 4.72. Каталог файловой системы, который служит общим репозиторием для временных файлов в Интернете. Типичный путь — C:\Documents and Settings\username\Local Settings\Temporary Internet Files. |
|
Версия 5.0. Каталог файловой системы, который служит репозиторием данных для локальных (некормированных) приложений. Типичный путь — C:\Documents and Settings\username\Local Settings\Application Data. |
|
Версия 6.0. Виртуальная папка, представляющая элемент рабочего стола "Мои документы". Это значение эквивалентно CSIDL_PERSONAL. |
|
Каталог файловой системы, который служит общим репозиторием для музыкальных файлов. Типичный путь — C:\Documents and Settings\User\My Documents\My Music. |
|
Версия 5.0. Каталог файловой системы, который служит общим репозиторием для файлов образов. Типичный путь — C:\Documents and Settings\username\My Documents\My Pictures. |
|
Версия 6.0. Каталог файловой системы, который служит общим репозиторием для видеофайлов. Типичный путь — C:\Documents and Settings\username\My Documents\My Videos. |
|
Каталог файловой системы, содержащий объекты ссылок, которые могут существовать в виртуальной папке Сетевое окружение. Это не то же самое, что CSIDL_NETWORK, представляющий корень сетевого пространства имен. Типичный путь — C:\Documents and Settings\username\NetHood. |
|
Виртуальная папка, представляющая сетевое окружение, корень иерархии сетевого пространства имен. |
|
Версия 6.0. Виртуальная папка, представляющая элемент рабочего стола "Мои документы". Это эквивалентно CSIDL_MYDOCUMENTS. До версии 6.0. Каталог файловой системы, используемый для физического хранения общего репозитория документов пользователя. Типичный путь — C:\Documents and Settings\username\My Documents. Это следует отличать от виртуальной папки "Мои документы" в пространстве имен. Чтобы получить доступ к этой виртуальной папке, используйте SHGetFolderLocation, которая возвращает ITEMIDLIST для виртуального расположения, или обратитесь к методу, описанному в разделе Управление файловой системой. |
|
Виртуальная папка, содержащая установленные принтеры. |
|
Каталог файловой системы, содержащий объекты ссылок, которые могут существовать в виртуальной папке Принтеры. Типичный путь — C:\Documents and Settings\username\PrintHood. |
|
Версия 5.0. Папка профиля пользователя. Типичный путь — C:\Users\username. Приложения не должны создавать файлы или папки на этом уровне; они должны помещать свои данные в расположения, на которые ссылается CSIDL_APPDATA или CSIDL_LOCAL_APPDATA. Однако при создании новой известной папки корень профиля, на который ссылается CSIDL_PROFILE, подходит. |
|
Версия 5.0. Папка Program Files. Типичный путь — C:\Program Files. |
|
|
|
Версия 5.0. Папка для компонентов, совместно используемых несколькими приложениями. Типичный путь — C:\Program Files\Common. Допустимо только для Windows XP. |
|
|
|
Каталог файловой системы, содержащий группы программ пользователя (которые сами являются каталогами файловой системы). Типичный путь — C:\Documents and Settings\username\Start Menu\Programs. |
|
Каталог файловой системы, содержащий ярлыки для последних использованных документов пользователя. Типичный путь — C:\Documents and Settings\username\My Recent Documents. Чтобы создать ярлык в этой папке, используйте SHAddToRecentDocs. Помимо создания ярлыка, эта функция обновляет список последних документов оболочки и добавляет ярлык в подменю Мои последние документы меню "Пуск ". |
|
Windows Vista. Каталог файловой системы, содержащий данные ресурсов. Типичный путь — C:\Windows\Resources. |
|
|
|
Каталог файловой системы, содержащий пункты меню "Отправить ". Типичный путь — C:\Documents и Settings\username\SendTo. |
|
Каталог файловой системы, содержащий элементы меню "Пуск ". Типичный путь — C:\Documents and Settings\username\Start Menu. |
|
Каталог файловой системы, соответствующий группе программы запуска пользователя. Система запускает эти программы при каждом входе связанного пользователя. Типичный путь — C:\Documents and Settings\username\Start Menu\Programs\Startup. |
|
Версия 5.0. Папка System ОС Windows. Типичный путь — C:\Windows\System32. |
|
|
|
Каталог файловой системы, который выступает в качестве общего репозитория для шаблонов документов. Типичный путь — C:\Documents и Settings\username\Templates. |
|
Версия 5.0. Каталог Windows или SYSROOT. Это соответствует переменным среды %windir% и %SYSTEMROOT%. Типичный путь — C:\Windows. |
|
|
|
Версия 5.0. Объединение с другим CSIDL для принудительного создания связанной папки, если она не существует. |
|
Объедините с другой константой CSIDL, чтобы обеспечить расширение переменных среды. |
|
Объедините с другой константой CSIDL, за исключением CSIDL_FLAG_CREATE, чтобы вернуть непроверенный путь к папке без попыток создания или инициализации папки. |
|
Объедините с другой константой CSIDL, чтобы гарантировать получение истинного системного пути к папке без каких-либо псевдонимов заполнителей, таких как %USERPROFILE%, возвращаемых SHGetFolderLocation. Этот флаг не влияет на пути, возвращаемые SHGetFolderPath. |
|
|
|
Маска для любого допустимого значения флага CSIDL. |
Комментарии
Эти значения заменяют использование переменных среды для этой цели. Они, в свою очередь, заменяются в Windows Vista и более поздних версиях значениями KNOWNFOLDERID .
CSIDL используется в сочетании с одной из четырех функций оболочки SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation и SHGetSpecialFolderPath, чтобы получить путь к специальной папке или указатель на список идентификаторов элементов (PIDL).
Объедините CSIDL_FLAG_CREATE с любым другим CSIDL, за исключением CSIDL_FLAG_DONT_VERIFY, чтобы принудительно создать связанную папку. Остальные CSIDL соответствуют папкам файловой системы или виртуальным папкам. Если CSIDL идентифицирует папку файловой системы, в качестве примера приведен часто используемый путь. Могут использоваться и другие пути. Некоторые CSIDL можно сопоставить с эквивалентной переменной среды %VariableName%. Однако CSIDL являются более надежными, и их следует использовать по возможности.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
См. также раздел