Cartelle note
Windows Vista introduce nuovi scenari di archiviazione e un nuovo spazio dei nomi del profilo utente. Per risolvere questi nuovi fattori, il sistema precedente di riferimento alle cartelle standard in base a un valore CSIDL è stato sostituito. A partire da Windows Vista, tali cartelle vengono a cui fa riferimento un nuovo set di valori GUID denominati ID cartella nota.
Il sistema cartella nota offre questi vantaggi:
- I fornitori di software indipendenti (ISV) possono estendere il set di ID cartelle note con i propri. Possono definire cartelle, assegnarle ID e registrarle con il sistema. Impossibile estendere i valori CSIDL.
- Tutte le cartelle note in un sistema possono essere enumerate. Nessuna API ha fornito questa funzionalità per i valori CSIDL. Per altre informazioni , vedere IKnownFolderManager::GetFolderIds .
- Una cartella nota aggiunta da un ISV può aggiungere proprietà personalizzate che consentono di spiegarne lo scopo e l'uso previsto.
- Molte cartelle note possono essere reindirizzate a nuove posizioni, incluse le posizioni di rete. Nel sistema CSIDL è possibile reindirizzare solo la cartella Documenti personali.
- Le cartelle note possono avere gestori personalizzati da usare durante la creazione o l'eliminazione.
Il sistema CSIDL e le API che usano i valori CSIDL sono ancora supportati per la compatibilità. Tuttavia, non è consigliabile usarli in qualsiasi nuovo sviluppo.
Gli argomenti seguenti illustrano le specifiche del sistema Cartelle note.
- Uso di cartelle note nelle applicazioni
- Come estendere cartelle note con cartelle personalizzate
- KNOWNFOLDERID
Le pagine di riferimento seguenti illustrano le funzioni Cartelle note Win32, che possono essere usate per recuperare il percorso delle cartelle note o reindirizzarle a una nuova posizione. Queste funzioni sostituiscono le funzioni Win32 precedenti. Le nuove funzioni vengono fornite per dare un comportamento equivalente alle funzioni precedenti, ma ogni nuova funzione viene duplicata anche da un'API COM (Component Object Model).
| Nuova funzione | Sostituisce | Equivalente COM |
|---|---|---|
| SHGetKnownFolderPath | Shgetfolderpath | IKnownFolder::GetPath |
| SHGetKnownFolderIDList | SHGetFolderLocation | IKnownFolder::GetIDList |
| SHSetKnownFolderPath | SHSetFolderPath | IKnownFolder::SetPath |
Le pagine di riferimento seguenti illustrano le API cartelle note COM, che forniscono tutte le funzionalità delle API Win32 elencate in precedenza, oltre a aggiungere la possibilità di enumerare tutte le cartelle note, accedere alle proprietà delle cartelle note e estendere il set standard di cartelle note.
Un esempio C++ che illustra le API di cartella note è inclusa in Windows Software Development Kit (SDK). Dopo aver installato Windows SDK nel computer, l'esempio può essere trovato in %ProgramFiles%\Microsoft SDKs\Windows\v6.0\Samples\WinUI\Shell\AppPlatform\KnownFolders.