Lire en anglais

Partager via


CSIDL

Notes

À partir de Windows Vista, ces valeurs ont été remplacées par des valeurs KNOWNFOLDERID . Consultez cette rubrique pour obtenir la liste des nouvelles constantes et leurs valeurs CSIDL correspondantes. Pour plus de commodité, les valeurs KNOWNFOLDERID correspondantes sont également indiquées ici pour chaque valeur CSIDL.

Le système CSIDL est pris en charge sous Windows Vista pour des raisons de compatibilité. Toutefois, le nouveau développement doit utiliser des valeurs KNOWNFOLDERID plutôt que des valeurs CSIDL.

 

Les valeurs CSIDL (constant special item ID list) fournissent un moyen unique indépendant du système d’identifier les dossiers spéciaux fréquemment utilisés par les applications, mais qui peuvent ne pas avoir le même nom ou emplacement sur un système donné. Par exemple, le dossier système peut être « C:\Windows » sur un système et « C:\Winnt » sur un autre. Ces constantes sont définies dans Shlobj.h.

Constante/valeur Description
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
Version 5.0. Répertoire de système de fichiers utilisé pour stocker des outils d'administration pour un utilisateur donné. La console MMC enregistre les consoles personnalisées dans ce répertoire et elle est itinérante avec l’utilisateur.
CSIDL_ALTSTARTUP
FOLDERID_Startup
Répertoire du système de fichiers qui correspond au groupe de programmes de démarrage non localisé de l’utilisateur. Cette valeur est reconnue dans Windows Vista pour la compatibilité descendante, mais le dossier lui-même n’existe plus.
CSIDL_APPDATA
FOLDERID_RoamingAppData
Version 4.71. Répertoire du système de fichiers qui sert de référentiel commun pour les données spécifiques à l’application. Un chemin d’accès classique est C:\Documents and Settings\username\Application Data.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
Dossier virtuel qui contient les objets dans la Corbeille de l’utilisateur.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
Version 6.0. Répertoire du système de fichiers qui agit en tant que zone de transit pour les fichiers qui attendent d'être écrits sur un CD. Un chemin d’accès classique est C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Version 5.0. Répertoire du système de fichiers qui contient des outils d'administration pour tous les utilisateurs de l'ordinateur.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
Répertoire du système de fichiers qui correspond au groupe de programmes de démarrage non localisé pour tous les utilisateurs. Cette valeur est reconnue dans Windows Vista pour la compatibilité descendante, mais le dossier lui-même n’existe plus.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
Version 5.0. Répertoire de système de fichiers qui contient les données d’application pour tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Application Data. Ce dossier est utilisé pour les données d’application qui ne sont pas spécifiques à l’utilisateur. Par exemple, une application peut stocker un dictionnaire case activée l’orthographe, une base de données d’images clipart ou un fichier journal dans le dossier CSIDL_COMMON_APPDATA. Ces informations ne sont pas itinérantes et sont disponibles pour toute personne utilisant l’ordinateur.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
Répertoire du système de fichiers qui contient des fichiers et des dossiers qui s'affichent sur le Bureau pour tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Desktop.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
Répertoire du système de fichiers qui contient des documents qui sont communs à tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Documents.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
Répertoire de système de fichiers qui sert de référentiel commun pour les éléments favoris communs à tous les utilisateurs.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
Version 6.0. Répertoire du système de fichiers qui sert de référentiel pour les fichiers audio communs à tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Documents\My Music.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Cette valeur est reconnue dans Windows Vista pour la compatibilité descendante, mais le dossier lui-même n’est plus utilisé.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
Version 6.0. Répertoire du système de fichiers qui sert de référentiel pour les fichiers image communs à tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Documents\My Pictures.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
Répertoire du système de fichiers qui contient les répertoires des groupes de programmes courants qui s’affichent dans le menu Démarrer pour tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Start Menu\Programs.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
Répertoire du système de fichiers qui contient les programmes et dossiers qui s’affichent dans le menu Démarrer pour tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Start Menu.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
Répertoire du système de fichiers qui contient les programmes qui s'affichent dans le dossier Démarrage pour tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Start Menu\Programs\Startup.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
Répertoire du système de fichiers qui contient les modèles qui sont disponibles pour tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Templates.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
Version 6.0. Répertoire du système de fichiers qui sert de référentiel pour les fichiers vidéo communs à tous les utilisateurs. Un chemin d’accès classique est C:\Documents and Settings\All Users\Documents\My Videos.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
Dossier qui représente d’autres ordinateurs de votre groupe de travail.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
Dossier virtuel qui représente les connexions réseau, qui contient les connexions réseau et d’accès à distance.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
Dossier virtuel qui contient des icônes pour les applications Panneau de configuration.
CSIDL_COOKIES
FOLDERID_Cookies
Répertoire du système de fichiers qui sert de référentiel commun pour les cookies Internet. Un chemin d’accès classique est C:\Documents and Settings\username\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
Dossier virtuel qui représente le bureau Windows, la racine de l’espace de noms.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
Répertoire du système de fichiers utilisé pour stocker physiquement des objets de fichiers sur le bureau (à ne pas confondre avec le dossier de bureau lui-même). Un chemin d’accès classique est C:\Documents and Settings\username\Desktop.
CSIDL_DRIVES
FOLDERID_ComputerFolder
Dossier virtuel qui représente Poste de travail, contenant tout ce qui se trouve sur l’ordinateur local : périphériques de stockage, imprimantes et Panneau de configuration. Le dossier peut également contenir des lecteurs réseau mappés.
CSIDL_FAVORITES
FOLDERID_Favorites
Répertoire du système de fichiers qui sert de référentiel commun pour les éléments favoris de l’utilisateur. Un chemin d’accès classique est C:\Documents and Settings\username\Favorites.
CSIDL_FONTS
FOLDERID_Fonts
Dossier virtuel qui contient des polices. Un chemin d’accès classique est C:\Windows\Fonts.
CSIDL_HISTORY
FOLDERID_History
Répertoire du système de fichiers qui sert de référentiel commun pour les éléments d’historique Internet.
CSIDL_INTERNET
FOLDERID_InternetFolder
Dossier virtuel pour les Explorer Internet.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
Version 4.72. Répertoire du système de fichiers qui sert de référentiel commun pour les fichiers Internet temporaires. Un chemin d’accès classique est C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
Version 5.0. Répertoire de système de fichiers qui sert de référentiel de données pour les applications locales (sans déplacement). Un chemin d’accès classique est C:\Documents and Settings\username\Local Settings\Application Data.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Version 6.0. Dossier virtuel qui représente l’élément de bureau Mes documents. Cette valeur équivaut à CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
Répertoire du système de fichiers qui sert de référentiel commun pour les fichiers de musique. Un chemin d’accès classique est C:\Documents and Settings\User\My Documents\My Music.
CSIDL_MYPICTURES
FOLDERID_Pictures
Version 5.0. Répertoire du système de fichiers qui sert de référentiel commun pour les fichiers image. Un chemin d’accès classique est C:\Documents and Settings\username\My Documents\My Pictures.
CSIDL_MYVIDEO
FOLDERID_Videos
Version 6.0. Répertoire du système de fichiers qui sert de référentiel commun pour les fichiers vidéo. Un chemin d’accès classique est C:\Documents and Settings\username\My Documents\My Videos.
CSIDL_NETHOOD
FOLDERID_NetHood
Répertoire du système de fichiers qui contient les objets de lien qui peuvent exister dans le dossier virtuel Favoris réseau. Il n’est pas identique à CSIDL_NETWORK, qui représente la racine de l’espace de noms réseau. Un chemin d’accès classique est C:\Documents and Settings\username\NetHood.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Dossier virtuel qui représente le voisinage réseau, la racine de la hiérarchie de l’espace de noms réseau.
CSIDL_PERSONAL
FOLDERID_Documents
Version 6.0. Dossier virtuel qui représente l’élément de bureau Mes documents. Cela équivaut à CSIDL_MYDOCUMENTS.
Avant la version 6.0. Répertoire de système de fichiers utilisé pour stocker physiquement le référentiel commun de documents d’un utilisateur. Un chemin d’accès classique est C:\Documents and Settings\username\My Documents. Il doit être distingué du dossier virtuel Mes documents dans l’espace de noms. Pour accéder à ce dossier virtuel, utilisez SHGetFolderLocation, qui retourne l’ITEMIDLIST pour l’emplacement virtuel, ou reportez-vous à la technique décrite dans Gestion du système de fichiers.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
Dossier virtuel qui contient les imprimantes installées.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
Répertoire du système de fichiers qui contient les objets de lien qui peuvent exister dans le dossier virtuel Imprimantes. Un chemin d’accès classique est C:\Documents and Settings\username\PrintHood.
CSIDL_PROFILE
FOLDERID_Profile
Version 5.0. Dossier du profil utilisateur. Un chemin d’accès classique est C:\Users\username. Les applications ne doivent pas créer de fichiers ou de dossiers à ce niveau ; ils doivent placer leurs données sous les emplacements auxquels il est fait référence par CSIDL_APPDATA ou CSIDL_LOCAL_APPDATA. Toutefois, si vous créez un dossier connu, la racine de profil référencée par CSIDL_PROFILE est appropriée.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Version 5.0. Dossier Program Files. Un chemin d’accès classique est C:\Program Files.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Version 5.0. Dossier destiné aux composants partagés par plusieurs applications. Un chemin d’accès classique est C:\Program Files\Common. Valide uniquement pour Windows XP.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
Répertoire du système de fichiers qui contient les groupes de programmes de l’utilisateur (qui sont eux-mêmes des répertoires de système de fichiers). Un chemin d’accès classique est C:\Documents and Settings\username\Start Menu\Programs.
CSIDL_RECENT
FOLDERID_Recent
Répertoire du système de fichiers qui contient les raccourcis vers les derniers documents utilisés par l’utilisateur. Un chemin d’accès classique est C:\Documents and Settings\username\My Recent Documents. Pour créer un raccourci dans ce dossier, utilisez SHAddToRecentDocs. En plus de créer le raccourci, cette fonction met à jour la liste des documents récents de l’interpréteur de commandes et ajoute le raccourci au sous-menu Mes documents récents du menu Démarrer .
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista. Répertoire du système de fichiers qui contient des données de ressource. Un chemin d’accès classique est C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
Répertoire du système de fichiers qui contient les éléments de menu Envoyer à . Un chemin d’accès classique est C:\Documents and Settings\username\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
Répertoire du système de fichiers qui contient les éléments du menu Démarrer . Un chemin d’accès classique est C:\Documents and Settings\username\Menu Démarrer.
CSIDL_STARTUP
FOLDERID_Startup
Répertoire du système de fichiers qui correspond au groupe de programmes de démarrage de l’utilisateur. Le système démarre ces programmes chaque fois que l’utilisateur associé se connecte. Un chemin d’accès classique est C:\Documents and Settings\username\Start Menu\Programs\Startup.
CSIDL_SYSTEM
FOLDERID_System
Version 5.0. Dossiers Système Windows. Un chemin d’accès classique est C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
Répertoire du système de fichiers qui sert de référentiel commun pour les modèles de documents. Un chemin d’accès classique est C:\Documents and Settings\username\Templates.
CSIDL_WINDOWS
FOLDERID_Windows
Version 5.0. Répertoire Windows ou SYSROOT. Correspond aux variables d'environnement %windir% ou % SYSTEMROOT%. Un chemin d’accès classique est C:\Windows.
Indicateurs
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Version 5.0. Combinez avec un autre CSIDL pour forcer la création du dossier associé s’il n’existe pas.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Combinez avec une autre constante CSIDL pour garantir l’expansion des variables d’environnement.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
Combinez avec une autre constante CSIDL, à l’exception de CSIDL_FLAG_CREATE, pour retourner un chemin d’accès de dossier non vérifié sans tentative de création ou d’initialisation du dossier.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
Combinez avec une autre constante CSIDL pour garantir la récupération du chemin d’accès système réel pour le dossier, sans aucun espace réservé avec alias tel que %USERPROFILE%, retourné par SHGetFolderLocation. Cet indicateur n’a aucun effet sur les chemins retournés par SHGetFolderPath.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
Masque pour toute valeur d’indicateur CSIDL valide.

Notes

Ces valeurs remplacent l’utilisation de variables d’environnement à cet effet. Elles sont à leur tour remplacées dans Windows Vista et ultérieurement par les valeurs KNOWNFOLDERID .

Un CSIDL est utilisé conjointement avec l’une des quatre fonctions shell, SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation et SHGetSpecialFolderPath, pour récupérer le chemin d’accès ou le pointeur d’un dossier spécial vers une liste d’identificateurs d’élément (PIDL).

Combinez CSIDL_FLAG_CREATE avec l’un des autres CSIDL, à l’exception de CSIDL_FLAG_DONT_VERIFY, pour forcer la création du dossier associé. Les CSIDL restants correspondent à des dossiers de système de fichiers ou à des dossiers virtuels. Lorsque le CSIDL identifie un dossier de système de fichiers, un chemin d’accès couramment utilisé est donné à titre d’exemple. D’autres chemins peuvent être utilisés. Certains CSIDL peuvent être mappés à une variable d’environnement %VariableName% équivalente. Toutefois, les CSIDL sont plus fiables et doivent être utilisés si possible.

Spécifications

Condition requise Valeur
En-tête
Shlobj.h

Voir aussi

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG