Dossiers connus
Windows Vista introduit de nouveaux scénarios de stockage et un nouvel espace de noms de profil utilisateur. Pour répondre à 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é id de dossier connu.
Le système de dossiers connu offre les avantages suivants :
- Les éditeurs de logiciels indépendants (ISV) peuvent étendre l’ensemble des ID de dossiers connus avec leur propre ID. Ils peuvent définir des dossiers, leur attribuer des ID et les inscrire auprès du système. Impossible d’étendre les valeurs CSIDL.
- Tous les dossiers connus sur un système peuvent être énumérés. Aucune API n’offrait 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 rôle 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 peut ê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 font appel aux valeurs CSIDL sont toujours pris en charge pour la compatibilité. Toutefois, il n’est pas recommandé de les utiliser dans un nouveau développement.
Les rubriques suivantes décrivent les caractéristiques du système de 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 de 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 fournir 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 décrivent les API de dossiers connus COM, qui fournissent toutes les fonctionnalités des API Win32 répertoriées ci-dessus, ainsi que la possibilité d’énumérer tous les dossiers connus, d’accéder aux propriétés de dossier connues et d’étendre l’ensemble standard de dossiers connus.
un exemple C++ qui illustre les api de dossiers connus est inclus dans le kit de développement logiciel (SDK) Windows. une fois que vous avez installé le SDK Windows sur votre ordinateur, l’exemple se trouve sous% ProgramFiles% \ Microsoft sdk \ Windows \ v 6.0 \ samples \ WinUI \ Shell \ AppPlatform \ fichier knownfolders.