CSIDL

Hinweis

Ab Windows Vista wurden diese Werte durch KNOWNFOLDERID-Werte ersetzt. Eine Liste der neuen Konstanten und der entsprechenden CSIDL-Werte finden Sie in diesem Thema. Der Einfachheit halber werden hier auch entsprechende KNOWNFOLDERID-Werte für jeden CSIDL-Wert notiert.

Das CSIDL-System wird aus Kompatibilitätsgründen unter Windows Vista unterstützt. Bei der Neuentwicklung sollten jedoch KNOWNFOLDERID-Werte anstelle von CSIDL-Werten verwendet werden.

 

CSIDL-Werte (Constant Special Item ID List) bieten eine eindeutige systemunabhängige Möglichkeit, spezielle Ordner zu identifizieren, die häufig von Anwendungen verwendet werden, aber möglicherweise nicht denselben Namen oder Speicherort auf einem bestimmten System haben. Der Systemordner kann beispielsweise "C:\Windows" auf einem System und "C:\Winnt" auf einem anderen system sein. Diese Konstanten werden in Shlobj.h definiert.

Konstante/Wert BESCHREIBUNG
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
Version 5.0. Das Dateisystemverzeichnis, das zum Speichern von Verwaltungstools für einen einzelnen Benutzer verwendet wird. Die MMC speichert angepasste Konsolen in diesem Verzeichnis, und es wird mit dem Benutzer verschoben.
CSIDL_ALTSTARTUP
FOLDERID_Startup
Das Dateisystemverzeichnis, das der nicht zugeordneten Startprogrammgruppe des Benutzers entspricht. Dieser Wert wird in Windows Vista aufgrund der Abwärtskompatibilität erkannt, aber der Ordner selbst ist nicht mehr vorhanden.
CSIDL_APPDATA
FOLDERID_RoamingAppData
Version 4.71. Das Dateisystemverzeichnis, das als gemeinsames Repository für anwendungsspezifische Daten dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Anwendungsdaten.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
Der virtuelle Ordner, der die Objekte im Papierkorb des Benutzers enthält.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
Version 6.0. Das Dateisystemverzeichnis, das als Stagingbereich für Dateien fungiert, die auf eine CD geschrieben werden sollen. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Lokale Einstellungen\Anwendungsdaten\Microsoft\CD Burning.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Version 5.0. Das Dateisystemverzeichnis, das Verwaltungstools für alle Benutzer des Computers enthält.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
Das Dateisystemverzeichnis, das der nicht zugeordneten Startprogrammgruppe für alle Benutzer entspricht. Dieser Wert wird in Windows Vista aufgrund der Abwärtskompatibilität erkannt, aber der Ordner selbst ist nicht mehr vorhanden.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
Version 5.0. Das Dateisystemverzeichnis, das Anwendungsdaten für alle Benutzer enthält. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Anwendungsdaten. Dieser Ordner wird für Anwendungsdaten verwendet, die nicht benutzerspezifisch sind. Beispielsweise kann eine Anwendung ein Wörterbuch zur Rechtschreibprüfung, eine Datenbank mit Cliparts oder eine Protokolldatei im Ordner CSIDL_COMMON_APPDATA speichern. Diese Informationen werden nicht übertragen und sind für alle Benutzer verfügbar, die den Computer verwenden.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
Das Dateisystemverzeichnis, das Dateien und Ordner enthält, die auf dem Desktop für alle Benutzer angezeigt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Desktop.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
Das Dateisystemverzeichnis, das Dokumente enthält, die von allen Benutzern gemeinsam genutzt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Dokumente.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
Das Dateisystemverzeichnis, das als gemeinsames Repository für bevorzugte Elemente dient, die allen Benutzern gemeinsam sind.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
Version 6.0. Das Dateisystemverzeichnis, das als Repository für Musikdateien dient, die von allen Benutzern gemeinsam genutzt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Dokumente\Meine Musik.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Dieser Wert wird in Windows Vista aufgrund der Abwärtskompatibilität erkannt, aber der Ordner selbst wird nicht mehr verwendet.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
Version 6.0. Das Dateisystemverzeichnis, das als Repository für Bilddateien dient, die von allen Benutzern gemeinsam genutzt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Dokumente\Meine Bilder.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
Das Dateisystemverzeichnis, das die Verzeichnisse für die allgemeinen Programmgruppen enthält, die im Startmenü für alle Benutzer angezeigt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Startmenü\Programme.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
Das Dateisystemverzeichnis, das die Programme und Ordner enthält, die im Menü Start für alle Benutzer angezeigt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Startmenü.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
Das Dateisystemverzeichnis, das die Programme enthält, die im Ordner Startup für alle Benutzer angezeigt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Startmenü\Programme\Start.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
Das Dateisystemverzeichnis, das die für alle Benutzer verfügbaren Vorlagen enthält. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Vorlagen.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
Version 6.0. Das Dateisystemverzeichnis, das als Repository für Musikdateien dient, die von allen Benutzern gemeinsam genutzt werden. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Alle Benutzer\Dokumente\Meine Videos.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
Der Ordner, der andere Computer in Ihrer Arbeitsgruppe darstellt.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
Der virtuelle Ordner, der Netzwerkverbindungen darstellt, der Netzwerk- und DFÜ-Verbindungen enthält.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
Der virtuelle Ordner, der Symbole für die Systemsteuerung Anwendungen enthält.
CSIDL_COOKIES
FOLDERID_Cookies
Das Dateisystemverzeichnis, das als gemeinsames Repository für Internetcookies dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
Der virtuelle Ordner, der den Windows-Desktop darstellt, das Stammverzeichnis des Namespace.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
Das Dateisystemverzeichnis, das zum physischen Speichern von Dateiobjekten auf dem Desktop verwendet wird (nicht zu verwechseln mit dem Desktopordner selbst). Ein typischer Pfad ist C:\Documents and Settings\username\Desktop.
CSIDL_DRIVES
FOLDERID_ComputerFolder
Der virtuelle Ordner, der "Arbeitsplatz" darstellt und alles auf dem lokalen Computer enthält: Speichergeräte, Drucker und Systemsteuerung. Der Ordner kann auch zugeordnete Netzwerklaufwerke enthalten.
CSIDL_FAVORITES
FOLDERID_Favorites
Das Dateisystemverzeichnis, das als gemeinsames Repository für die bevorzugten Elemente des Benutzers dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Favoriten.
CSIDL_FONTS
FOLDERID_Fonts
Ein virtueller Ordner, der Schriftarten enthält. Ein typischer Pfad ist C:\Windows\Fonts.
CSIDL_HISTORY
FOLDERID_History
Das Dateisystemverzeichnis, das als gemeinsames Repository für Internetverlaufselemente dient.
CSIDL_INTERNET
FOLDERID_InternetFolder
Ein virtueller Ordner für internet Explorer.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
Version 4.72. Das Dateisystemverzeichnis, das als gemeinsames Repository für temporäre Internetdateien dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Lokale Einstellungen\Temporäre Internetdateien.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
Version 5.0. Das Dateisystemverzeichnis, das als Datenrepository für lokale (nichtroamierende) Anwendungen dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Lokale Einstellungen\Anwendungsdaten.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Version 6.0. Der virtuelle Ordner, der das Desktopelement "Eigene Dokumente" darstellt. Dieser Wert entspricht CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
Das Dateisystemverzeichnis, das als gemeinsames Repository für Musikdateien dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzer\Eigene Dokumente\Meine Musik.
CSIDL_MYPICTURES
FOLDERID_Pictures
Version 5.0. Das Dateisystemverzeichnis, das als gemeinsames Repository für Imagedateien dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Eigene Dokumente\Meine Bilder.
CSIDL_MYVIDEO
FOLDERID_Videos
Version 6.0. Das Dateisystemverzeichnis, das als gemeinsames Repository für Videodateien dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Eigene Dokumente\Meine Videos.
CSIDL_NETHOOD
FOLDERID_NetHood
Ein Dateisystemverzeichnis, das die Linkobjekte enthält, die im virtuellen Ordner Netzwerkumgebung vorhanden sein können. Sie ist nicht mit CSIDL_NETWORK identisch, die den Netzwerknamespacestamm darstellt. Ein typischer Pfad ist C:\Documents and Settings\username\NetHood.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Ein virtueller Ordner, der die Netzwerkumgebung darstellt, das Stammverzeichnis der Netzwerknamespacehierarchie.
CSIDL_PERSONAL
FOLDERID_Documents
Version 6.0. Der virtuelle Ordner, der das Desktopelement "Eigene Dokumente" darstellt. Dies entspricht CSIDL_MYDOCUMENTS.
Vor Version 6.0. Das Dateisystemverzeichnis, das zum physischen Speichern des gemeinsamen Dokumentenrepositorys eines Benutzers verwendet wird. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Eigene Dokumente. Dies sollte vom virtuellen Ordner "Eigene Dokumente" im Namespace unterschieden werden. Um auf diesen virtuellen Ordner zuzugreifen, verwenden Sie SHGetFolderLocation, das die ITEMIDLIST für den virtuellen Speicherort zurückgibt, oder verweisen Sie auf die unter Verwalten des Dateisystems beschriebene Technik.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
Der virtuelle Ordner mit installierten Druckern.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
Das Dateisystemverzeichnis, das die Linkobjekte enthält, die im virtuellen Ordner Drucker vorhanden sein können. Ein typischer Pfad ist C:\Documents and Settings\username\PrintHood.
CSIDL_PROFILE
FOLDERID_Profile
Version 5.0. Der Profilordner des Benutzers. Ein typischer Pfad ist C:\Users\username. Anwendungen sollten keine Dateien oder Ordner auf dieser Ebene erstellen. sie sollten ihre Daten unter den Von CSIDL_APPDATA oder CSIDL_LOCAL_APPDATA genannten Speicherorten ablegen. Wenn Sie jedoch einen neuen bekannten Ordner erstellen, ist der Profilstamm, auf den CSIDL_PROFILE verwiesen wird, angemessen.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Version 5.0. Der Ordner Programme. Ein typischer Pfad ist C:\Programme.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Version 5.0. Ein Ordner für Komponenten, die von mehreren Anwendungen gemeinsam verwendet werden. Ein typischer Pfad ist C:\Programme\Common. Nur für Windows XP gültig.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
Das Dateisystemverzeichnis, das die Programmgruppen des Benutzers enthält (die selbst Dateisystemverzeichnisse sind). Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Startmenü\Programme.
CSIDL_RECENT
FOLDERID_Recent
Das Dateisystemverzeichnis, das Verknüpfungen zu den zuletzt verwendeten Dokumenten des Benutzers enthält. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Meine zuletzt verwendeten Dokumente. Verwenden Sie SHAddToRecentDocs, um eine Verknüpfung in diesem Ordner zu erstellen. Zusätzlich zum Erstellen der Verknüpfung aktualisiert diese Funktion die Liste der zuletzt verwendeten Dokumente der Shell und fügt die Verknüpfung dem Untermenü Meine zuletzt verwendeten Dokumente des Startmenüs hinzu.
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista Das Dateisystemverzeichnis, das Ressourcendaten enthält. Ein typischer Pfad ist C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
Das Dateisystemverzeichnis, das Die Menüelemente "Senden an" enthält. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
Das Dateisystemverzeichnis, das Startmenüelemente enthält. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Startmenü.
CSIDL_STARTUP
FOLDERID_Startup
Das Dateisystemverzeichnis, das der Startprogrammgruppe des Benutzers entspricht. Das System startet diese Programme, wenn sich der zugeordnete Benutzer anmeldet. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Startmenü\Programme\Start.
CSIDL_SYSTEM
FOLDERID_System
Version 5.0. Der Windows-Ordner System. Ein typischer Pfad ist C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
Das Dateisystemverzeichnis, das als gemeinsames Repository für Dokumentvorlagen dient. Ein typischer Pfad ist C:\Dokumente und Einstellungen\Benutzername\Vorlagen.
CSIDL_WINDOWS
FOLDERID_Windows
Version 5.0. Das Windows-Verzeichnis oder SYSROOT. Dies entspricht den Umgebungsvariablen %windir% oder %SYSTEMROOT%. Ein typischer Pfad ist C:\Windows.
Flags
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Version 5.0. Kombinieren Sie mit einer anderen CSIDL, um die Erstellung des zugeordneten Ordners zu erzwingen, wenn er nicht vorhanden ist.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Kombinieren Sie mit einer anderen CSIDL-Konstante, um die Erweiterung von Umgebungsvariablen sicherzustellen.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
Kombinieren Sie mit einer anderen CSIDL-Konstanten außer CSIDL_FLAG_CREATE, um einen nicht überprüften Ordnerpfad zurückzugeben, ohne den Ordner zu erstellen oder zu initialisieren.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
Kombinieren Sie mit einer anderen CSIDL-Konstante, um sicherzustellen, dass der wahre Systempfad für den Ordner frei von aliasierten Platzhaltern wie %USERPROFILE%, die von SHGetFolderLocation zurückgegeben werden, abgerufen wird. Dieses Flag hat keine Auswirkungen auf pfade, die von SHGetFolderPath zurückgegeben werden.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
Eine Maske für jeden gültigen CSIDL-Flagwert.

Bemerkungen

Diese Werte ersetzten die Verwendung von Umgebungsvariablen für diesen Zweck. Sie werden wiederum in Windows Vista und später durch die KNOWNFOLDERID-Werte abgelöst.

Eine CSIDL wird in Verbindung mit einer der vier Shellfunktionen SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation und SHGetSpecialFolderPath verwendet, um den Pfad oder Zeiger eines speziellen Ordners auf eine Elementbezeichnerliste (PIDL) abzurufen.

Kombinieren Sie CSIDL_FLAG_CREATE mit einer der anderen CSIDLs mit Ausnahme von CSIDL_FLAG_DONT_VERIFY, um die Erstellung des zugeordneten Ordners zu erzwingen. Die verbleibenden CSIDLs entsprechen entweder Dateisystemordnern oder virtuellen Ordnern. Wenn die CSIDL einen Dateisystemordner identifiziert, wird ein häufig verwendeter Pfad als Beispiel angegeben. Andere Pfade können verwendet werden. Einige CSIDLs können einer entsprechenden %VariableName%- Umgebungsvariablen zugeordnet werden. CSIDLs sind jedoch zuverlässiger und sollten nach Möglichkeit verwendet werden.

Anforderungen

Anforderung Wert
Header
Shlobj.h

Siehe auch

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG