Kända mappar
Windows Vista introducerar nya lagringsscenarier och ett nytt namnområde för användarprofiler. För att åtgärda dessa nya faktorer har det äldre systemet för att referera till standardmappar med ett CSIDL--värde ersatts. Från och med Windows Vista refereras dessa mappar av en ny uppsättning GUID-värden med namnet Kända mapp-ID:n.
Det kända mappsystemet ger följande fördelar:
- Oberoende programvaruleverantörer (ISV:er) kan utöka uppsättningen kända mapp-ID:n med sina egna. De kan definiera mappar, ge dem ID:t och registrera dem i systemet. DET gick inte att utöka CSIDL-värden.
- Alla kända mappar i ett system kan räknas upp. Inget API tillhandahöll den här funktionen för CSIDL-värden. Mer information finns i IKnownFolderManager::GetFolderIds.
- En känd mapp som lagts till av en ISV kan lägga till anpassade egenskaper som gör att den kan förklara dess syfte och avsedda användning.
- Många kända mappar kan omdirigeras till nya platser, inklusive nätverksplatser. Under CSIDL-systemet kunde endast mappen Mina dokument omdirigeras.
- Kända mappar kan ha anpassade hanterare för användning när de skapas eller tas bort.
CSIDL-systemet och API:erna som använder CSIDL-värden stöds fortfarande för kompatibilitet. Vi rekommenderar dock inte att du använder dem i någon ny utveckling.
I följande avsnitt beskrivs detaljerna i systemet Kända mappar.
Följande referenssidor förklarar funktionerna win32 kända mappar, som kan användas för att hämta platsen för kända mappar eller omdirigera dem till en ny plats. Dessa funktioner ersätter äldre Win32-funktioner. De nya funktionerna tillhandahålls för att ge motsvarande beteende till de gamla funktionerna, men varje ny funktion dupliceras också av ett COM-API (Component Object Model).
| Ny funktion | Ersätter | COM-motsvarighet |
|---|---|---|
| SHGetKnownFolderPath | SHGetFolderPath | IKnownFolder::GetPath |
| SHGetKnownFolderIDList | SHGetFolderLocation | IKnownFolder::GetIDList |
| SHSetKnownFolderPath | SHSetFolderPath | IKnownFolder::SetPath |
Följande referenssidor förklarar API:erna för COM-kända mappar, som tillhandahåller alla funktioner i Win32-API:erna som anges ovan, samt lägger till möjligheten att räkna upp alla kända mappar, komma åt egenskaper för kända mappar och utöka standarduppsättningen med kända mappar.
Ett C++-exempel som visar API:erna för kända mappar ingår i Windows Software Development Kit (SDK). När du har installerat Windows SDK på datorn finns exemplet under %ProgramFiles%\Microsoft SDKs\Windows\v6.0\Samples\WinUI\Shell\AppPlatform\KnownFolders.