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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Dossier virtuel qui contient les objets dans la Corbeille de l’utilisateur. |
|
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. |
|
Version 5.0. Répertoire du système de fichiers qui contient des outils d'administration pour tous les utilisateurs de l'ordinateur. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Répertoire de système de fichiers qui sert de référentiel commun pour les éléments favoris communs à tous les utilisateurs. |
|
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. |
|
Cette valeur est reconnue dans Windows Vista pour la compatibilité descendante, mais le dossier lui-même n’est plus utilisé. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Dossier qui représente d’autres ordinateurs de votre groupe de travail. |
|
Dossier virtuel qui représente les connexions réseau, qui contient les connexions réseau et d’accès à distance. |
|
Dossier virtuel qui contient des icônes pour les applications Panneau de configuration. |
|
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. |
|
Dossier virtuel qui représente le bureau Windows, la racine de l’espace de noms. |
|
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. |
|
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. |
|
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. |
|
Dossier virtuel qui contient des polices. Un chemin d’accès classique est C:\Windows\Fonts. |
|
Répertoire du système de fichiers qui sert de référentiel commun pour les éléments d’historique Internet. |
|
Dossier virtuel pour les Explorer Internet. |
|
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. |
|
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. |
|
Version 6.0. Dossier virtuel qui représente l’élément de bureau Mes documents. Cette valeur équivaut à CSIDL_PERSONAL. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Dossier virtuel qui représente le voisinage réseau, la racine de la hiérarchie de l’espace de noms réseau. |
|
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. |
|
Dossier virtuel qui contient les imprimantes installées. |
|
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. |
|
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. |
|
Version 5.0. Dossier Program Files. Un chemin d’accès classique est C:\Program Files. |
|
|
|
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. |
|
|
|
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. |
|
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 . |
|
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. |
|
|
|
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. |
|
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. |
|
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. |
|
Version 5.0. Dossiers Système Windows. Un chemin d’accès classique est C:\Windows\System32. |
|
|
|
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. |
|
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. |
|
|
|
Version 5.0. Combinez avec un autre CSIDL pour forcer la création du dossier associé s’il n’existe pas. |
|
Combinez avec une autre constante CSIDL pour garantir l’expansion des variables d’environnement. |
|
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. |
|
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. |
|
|
|
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 |
|
Voir aussi