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