Dela via

Arbeta med kända mappar i program

  • Artikel

Det kända mappsystemet är ett sätt att interagera med vissa högprofilmappar som finns som standard i Windows. Det tillåter också samma interaktioner med mappar som installerats och registrerats med det kända mappsystemet av program. I det här avsnittet beskrivs de möjliga interaktionerna eftersom de tillhandahålls av API:erna för kända mappar.

Viktig

Om du vill omdirigera mapparna Dokument, Bilder eller Skrivbord till OneDrive använder du OneDrive Known Folder Move i stället för den omdirigeringsmetod som beskrivs i den här artikeln. Mer information finns i Omdirigera och flytta kända Windows-mappar till OneDrive.

Kända mappgränssnitt

Det finns två kända mappgränssnitt: IKnownFolder och IKnownFolderManager.

IKnownFolderManager innehåller många av de mer allmänna funktionerna för dessa mappar. Med dess metoder kan du:

  • Hämta en IKnownFolder- baserat på antingen mappens KNOWNFOLDERID, dess kanoniska namn, dess sökväg uttryckt som en sträng eller dess sökväg uttryckt som en IDList.
  • Konvertera en CSIDL till dess KNOWNFOLDERID motsvarighet eller konvertera en KNOWNFOLDERID- till dess äldre CSIDL-motsvarighet.
  • Registrera eller avregistrera en känd mapp med systemet.
  • Hämta alla KNOWNFOLDERID- värden som registrerats i systemet.
  • Omdirigera en känd mapp till en ny plats.

IKnownFolder tillhandahåller en metod som gör att en mapp kan omdirigera sig själv genom att tillhandahålla en ny sökväg. Dess andra metoder får information om en specifik känd mapp, inklusive:

  • Kategorin för mappen: virtuell, fast, vanlig eller per användare.
  • Typ av mapp, till exempel komprimerade dokument, bilder eller användarfiler.
  • För mappen är KNOWNFOLDERID.
  • Den fullständiga sökvägen till mappen som en IDList eller som en sträng. Även dess relativa sökväg till en överordnad mapp.
  • Det kanoniska namnet på mappen.
  • Verktygstipset som visas för mappen.
  • Ikonen som visas för mappen.
  • En beskrivning av mappen som förklarar dess syfte och användning.
  • Om mappen kan omdirigeras.

IKnownFolder innehåller också en metod för att hämta en IShellItem utifrån mappen. Det gör att du kan binda mappen till en hanterare, jämföra två mappar och hämta mappens attribut, visningsnamn och överordnad mapp.

Omdirigering

Mappomdirigering är en viktig funktion i det kända mappsystemet. Alla kända mappar i kategorin vanligaKF_CATEGORY_COMMON**** eller per användareKF_CATEGORY_PERUSER**** kan omdirigeras. Mappen med kategorin virtuellaKF_CATEGORY_VIRTUAL**** eller KF_CATEGORY_FIXED****kan dock inte omdirigeras.

Mappar kan omdirigeras antingen till en annan plats på samma dator eller till en plats i ett nätverk. Vid en nätverksomdirigering kan mappen cachelagras lokalt via cachelagring på klientsidan för att ge offlineåtkomst. Men även om det finns en lokal cache måste den omdirigerade mappen nås via nätverket.

Mappomdirigering är inte nytt för Windows Vista. I Windows XP kan till exempel vissa mappar som identifieras via CSIDL-systemet omdirigeras via ett anrop till SHSetFolderPath- eller genom att ändra CSIDL-posten i registret. I Windows Vista och senare ska omdirigering utföras via IKnownFolder::SetPath eller SHSetKnownFolderPath.

För att avgöra om en mapp kan omdirigeras anropar du IKnownFolder::GetRedirectionCapabilities. Om mappen inte kan omdirigeras kan det här anropet ge en förklaring.

Om en mapp omdirigeras till en nätverksplats kan IKnownFolder metoder fortfarande anropas på den.

exempel på kända mappar