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, le système plus ancien de référence aux dossiers standard par une valeur CSIDL a été remplacé. À compter 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 ces avantages :

  • Les éditeurs de logiciels indépendants (ISV) peuvent étendre l’ensemble d’ID de dossier connus avec leur propre éditeur. 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 sur 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épendants 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 les 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 et les API CSIDL qui utilisent des valeurs CSIDL sont toujours prises en charge pour la compatibilité. Toutefois, il n’est pas recommandé de les utiliser dans n’importe quel nouveau développement.

Les rubriques suivantes décrivent les spécificités du système Dossiers connus.

Les pages de référence suivantes expliquent 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, ainsi que la possibilité d’énumérer tous les dossiers connus, d’accéder aux propriétés de dossiers connus et d’étendre l’ensemble standard de dossiers connus.

Un exemple C++ illustrant 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.

Dossiers connus, exemple