Utilisation de dossiers connus dans les applications
Le système de dossiers connu offre un moyen d’interagir avec certains dossiers de profil élevé qui sont présents par défaut dans Windows. Il autorise également ces mêmes interactions avec les dossiers installés et inscrits auprès du système de dossiers connus par les applications. Cette rubrique traite de ces interactions possibles telles qu’elles sont fournies par les API de dossiers connus.
Important
pour rediriger les Documents, images ou dossiers de bureau vers OneDrive, utilisez OneDrive déplacement de dossiers connus à la place de la méthode de redirection décrite dans cet article. pour plus d’informations, consultez redirection et déplacement Windows dossiers connus vers OneDrive.
Interfaces de dossiers connus
Il existe deux interfaces de dossier connues : IKnownFolder et IKnownFolderManager.
IKnownFolderManager fournit de nombreuses fonctions plus générales en ce qui concerne ces dossiers. Ses méthodes vous permettent d’effectuer les opérations suivantes :
- Récupérez un IKnownFolder basé sur le KNOWNFOLDERIDde ce dossier, son nom canonique, son chemin d’accès exprimé sous forme de chaîne ou son chemin d’accès exprimé sous la forme d’un IDList.
- Convertit un CSIDL en son équivalent KNOWNFOLDERID ou convertit un KNOWNFOLDERID en son équivalent CSIDL hérité.
- Inscrire ou désinscrire un dossier connu avec le système.
- Récupérez toutes les valeurs KNOWNFOLDERID inscrites sur ce système.
- Rediriger un dossier connu vers un nouvel emplacement.
IKnownFolder fournit une méthode qui permet à un dossier de se rediriger lui-même en fournissant un nouveau chemin d’accès. Ses autres méthodes obtiennent des informations sur un dossier connu spécifique, notamment :
- Catégorie du dossier : virtuel, fixe, commun ou par utilisateur.
- Type du dossier, tel que compressé, documents, images ou fichiers utilisateur.
- KNOWNFOLDERID du dossier.
- Chemin d’accès complet du dossier en tant que IDList ou chaîne. Également son chemin d’accès relatif à un dossier parent.
- Nom canonique du dossier.
- Info-bulle affichée pour le dossier.
- Icône affichée pour le dossier.
- Description du dossier qui explique son rôle et son utilisation.
- Indique si le dossier peut être redirigé.
IKnownFolder fournit également une méthode pour récupérer un IShellItem basé sur le dossier. Cela vous permet de lier le dossier à un gestionnaire, de comparer deux dossiers et de récupérer les attributs, le nom complet et le dossier parent du dossier.
Redirection
La redirection de dossiers est une fonctionnalité importante du système de dossiers connu. Tous les dossiers connus de la catégorie Common KF _ Category common _ * * * * ou par utilisateur KF _ Category _ PerUser * * * * sont redirigés. Toutefois, le dossier de catégorie KF virtuelle catégorie virtuelle * * * _ _ * ou de catégorie KF fixe _ _ * * * *ne peut pas être redirigé.
Les dossiers peuvent être redirigés vers un autre emplacement sur le même ordinateur ou vers un emplacement sur un réseau. Dans le cas d’une redirection de réseau, le dossier peut être mis en cache localement par le biais de la mise en cache côté client pour fournir un accès hors connexion. Toutefois, même en présence d’un cache local, le dossier redirigé lui-même doit être accessible via le réseau.
la redirection de dossiers n’est pas une nouveauté pour Windows Vista. par exemple, dans Windows XP, certains dossiers identifiés via le système CSIDL peuvent être redirigés par un appel à SHSetFolderPath ou en modifiant l’entrée de csidl dans le registre. dans Windows Vista et versions ultérieures, la redirection doit être effectuée via IKnownFolder :: SetPath ou SHSetKnownFolderPath.
Pour déterminer si un dossier peut être redirigé, appelez IKnownFolder :: GetRedirectionCapabilities. Si le dossier ne peut pas être redirigé, cet appel peut fournir une explication.
Si un dossier est redirigé vers un emplacement réseau, les méthodes IKnownFolder peuvent toujours être appelées avec succès.