Dossiers connus
Windows Vista introduit de nouveaux scénarios de stockage et un nouvel espace de noms de profil utilisateur. Pour résoudre ces nouveaux facteurs, l’ancien système de référence aux dossiers standard par une valeur CSIDL a été remplacé. À partir de Windows Vista, ces dossiers sont référencés par un nouvel ensemble de valeurs GUID appelées ID de dossier connus.
Le système de dossiers connus offre les avantages suivants :
- Les éditeurs de logiciels indépendants (ISV) peuvent étendre l’ensemble des ID de dossier connus avec leurs propres ID. Ils peuvent définir des dossiers, leur donner des ID et les inscrire auprès du système. Les valeurs CSIDL n’ont pas pu être étendues.
- Tous les dossiers connus d’un système peuvent être énumérés. Aucune API n’a fourni cette fonctionnalité pour les valeurs CSIDL. Pour plus d’informations, consultez IKnownFolderManager::GetFolderIds .
- Un dossier connu ajouté par un éditeur de logiciels indépendant peut ajouter des propriétés personnalisées qui lui permettent d’expliquer son objectif et son utilisation prévue.
- De nombreux dossiers connus peuvent être redirigés vers de nouveaux emplacements, y compris des emplacements réseau. Sous le système CSIDL, seul le dossier Mes documents a pu être redirigé.
- Les dossiers connus peuvent avoir des gestionnaires personnalisés à utiliser lors de la création ou de la suppression.
Le système CSIDL et les API qui utilisent des valeurs CSIDL sont toujours pris en charge à des fins de compatibilité. Toutefois, il n’est pas recommandé de les utiliser dans un nouveau développement.
Les rubriques suivantes traitent des spécificités du système dossiers connus.
- Utilisation de dossiers connus dans les applications
- Comment étendre des dossiers connus avec des dossiers personnalisés
- KNOWNFOLDERID
Les pages de référence suivantes décrivent les fonctions Dossiers connus Win32, qui peuvent être utilisées pour récupérer l’emplacement des dossiers connus ou les rediriger vers un nouvel emplacement. Ces fonctions remplacent les anciennes fonctions Win32. Les nouvelles fonctions sont fournies pour donner un comportement équivalent aux anciennes fonctions, mais chaque nouvelle fonction est également dupliquée par une API COM (Component Object Model).
| Nouvelle fonction | Remplace | Équivalent COM |
|---|---|---|
| SHGetKnownFolderPath | SHGetFolderPath | IKnownFolder::GetPath |
| SHGetKnownFolderIDList | SHGetFolderLocation | IKnownFolder::GetIDList |
| SHSetKnownFolderPath | SHSetFolderPath | IKnownFolder::SetPath |
Les pages de référence suivantes expliquent les API Dossiers connus COM, qui fournissent toutes les fonctionnalités des API Win32 répertoriées ci-dessus, et ajoutent la possibilité d’énumérer tous les dossiers connus, d’accéder aux propriétés des dossiers connus et d’étendre l’ensemble standard de dossiers connus.
Un exemple C++ qui illustre les API de dossier connu est inclus dans le Kit de développement logiciel (SDK) Windows. Une fois que vous avez installé le Kit de développement logiciel (SDK) Windows sur votre ordinateur, l’exemple se trouve sous %ProgramFiles%\Microsoft SDKs\Windows\v6.0\Samples\WinUI\Shell\AppPlatform\KnownFolders.