Ескертпе
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Жүйеге кіруді немесе каталогтарды өзгертуді байқап көруге болады.
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Каталогтарды өзгертуді байқап көруге болады.
Примечание
В 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 являются более надежными, и их следует использовать по возможности.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
См. также раздел