Utilizzo di cartelle note nelle applicazioni
Il sistema Cartella nota consente di interagire con determinate cartelle con profilo elevato presenti per impostazione predefinita in Windows. Consente inoltre le stesse interazioni con le cartelle installate e registrate con il sistema delle cartelle note da parte delle applicazioni. In questo argomento vengono descritte le possibili interazioni fornite dalle API cartella note.
Importante
Per reindirizzare le cartelle Documenti, Immagini o Desktop a OneDrive, usare Lo spostamento di cartelle note di OneDrive anziché il metodo di reindirizzamento descritto in questo articolo. Per informazioni, vedere Reindirizzare e spostare le cartelle note di Windows in OneDrive.
Interfacce di cartelle note
Esistono due interfacce delle cartelle note: IKnownFolder e IKnownFolderManager.
IKnownFolderManager fornisce molte delle funzioni più generali relative a queste cartelle. I relativi metodi consentono di:
- Recupera un IKnownFolder basandosi sull'KNOWNFOLDERID, sul nome canonico, sul percorso espresso come stringa o sull'IDList del percorso.
- Convertire un CSIDL nel suo equivalente KNOWNFOLDERID o convertire un KNOWNFOLDERID nel suo equivalente CSIDL legacy.
- Registrare o annullare la registrazione di una cartella nota con il sistema.
- Recuperare tutti i valori KNOWNFOLDERID registrati nel sistema.
- Reindirizzare una cartella nota a una nuova destinazione.
IKnownFolder fornisce un metodo che consente a una cartella di reindirizzarsi fornendo un nuovo percorso. Gli altri metodi ottengono informazioni su una cartella nota specifica, tra cui:
- Categoria della cartella: virtuale, fissa, comune o per utente.
- Tipo di cartella, ad esempio compressi, documenti, immagini o file utente.
- KNOWNFOLDERID della cartella.
- Percorso completo della cartella come IDList o come stringa. Anche il suo percorso relativo a una cartella superiore.
- Nome canonico della cartella.
- Descrizione comando visualizzata per la cartella.
- Icona visualizzata per la cartella.
- Descrizione della cartella che ne spiega lo scopo e l'uso.
- Indica se la cartella è in grado di essere reindirizzata.
IKnownFolder fornisce anche un metodo per recuperare un IShellItem in base alla cartella. Ciò consente di associare la cartella a un gestore, confrontare due cartelle e recuperare gli attributi della cartella, il nome visualizzato e la cartella padre.
Reindirizzamento
Il reindirizzamento delle cartelle è una funzionalità importante del sistema di cartelle note. Tutte le cartelle note della categoria comuneKF_CATEGORY_COMMON o per utenteKF_CATEGORY_PERUSER sono reindirizzabili. Impossibile reindirizzare la cartella della categoria virtualeKF_CATEGORY_VIRTUAL**** o fissaKF_CATEGORY_FIXED****.
Le cartelle possono essere reindirizzate a un'altra posizione nello stesso computer o a un percorso in una rete. Nel caso di un reindirizzamento di rete, la cartella può essere memorizzata nella cache locale utilizzando la funzionalità lato client per fornire l'accesso offline. Tuttavia, anche se esiste una cache locale, è necessario accedere alla cartella reindirizzata stessa tramite la rete.
Il reindirizzamento delle cartelle non è una novità per Windows Vista. Ad esempio, in Windows XP alcune cartelle identificate tramite il sistema CSIDL potrebbero essere reindirizzate tramite una chiamata a SHSetFolderPath o modificando la voce CSIDL nel Registro di sistema. In Windows Vista e versioni successive, il reindirizzamento deve essere eseguito tramite IKnownFolder::SetPath o SHSetKnownFolderPath.
Per determinare se è possibile reindirizzare una cartella, chiamare IKnownFolder::GetRedirectionCapabilities. Se la cartella non può essere reindirizzata, questa chiamata può fornire una spiegazione.
Se una cartella viene reindirizzata a un percorso di rete, i metodiIKnownFolderpossono comunque essere chiamati correttamente.
Argomenti correlati