CSIDL
Nota
A partire da Windows Vista, questi valori sono stati sostituiti da valori KNOWNFOLDERID . Vedere questo argomento per un elenco delle nuove costanti e dei relativi valori CSIDL corrispondenti. Per praticità, i valori KNOWNFOLDERID corrispondenti sono indicati qui anche per ogni valore CSIDL.
Il sistema CSIDL è supportato in Windows Vista per motivi di compatibilità. Tuttavia, il nuovo sviluppo deve usare valori KNOWNFOLDERID anziché valori CSIDL.
I valori CSIDL (costante elenco ID elemento speciale) forniscono un modo univoco indipendente dal sistema per identificare cartelle speciali usate spesso dalle applicazioni, ma che potrebbero non avere lo stesso nome o posizione in qualsiasi sistema specificato. Ad esempio, la cartella di sistema può essere "C:\Windows" in un sistema e "C:\Winnt" in un'altra. Queste costanti sono definite in Shlobj.h.
| Costante/valore | Descrizione |
|---|---|
|
Versione 5.0. Directory del file system usata per archiviare strumenti amministrativi per un singolo utente. MmC salva le console personalizzate in questa directory e verrà eseguito il roaming con l'utente. |
|
Directory del file system corrispondente al gruppo di programma di avvio non localizzato dell'utente. Questo valore viene riconosciuto in Windows Vista per la compatibilità con le versioni precedenti, ma la cartella stessa non esiste più. |
|
Versione 4.71. Directory del file system che funge da repository comune per i dati specifici dell'applicazione. Un percorso tipico è C:\Documents e Settings\username\Application Data. |
|
Cartella virtuale contenente gli oggetti nel Cestino dell'utente. |
|
Versione 6.0. Directory del file system che viene usata come un'area di gestione temporanea per i file in attesa di essere scritti su un CD. Un percorso tipico è C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning. |
|
Versione 5.0. Directory del file system che contiene strumenti amministrativi per tutti gli utenti del computer. |
|
Directory del file system corrispondente al gruppo di programma di avvio non localizzato per tutti gli utenti. Questo valore viene riconosciuto in Windows Vista per la compatibilità con le versioni precedenti, ma la cartella stessa non esiste più. |
|
Versione 5.0. Directory del file system contenente i dati dell'applicazione per tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Application Data. Questa cartella viene usata per i dati dell'applicazione che non sono specifici dell'utente. Ad esempio, un'applicazione può archiviare un dizionario di controllo ortografico, un database di clip art o un file di log nella cartella CSIDL_COMMON_APPDATA. Queste informazioni non verranno visualizzate e sono disponibili per chiunque usi il computer. |
|
Directory del file system che contiene file e cartelle che vengono visualizzati sul desktop di tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Desktop. |
|
Directory del file system che contiene documenti comuni a tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Documents. |
|
Directory del file system che funge da repository comune per gli elementi preferiti comuni a tutti gli utenti. |
|
Versione 6.0. Directory del file system che viene usata come repository per i file musicali comuni a tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Documents\My Music. |
|
Questo valore viene riconosciuto in Windows Vista per la compatibilità con le versioni precedenti, ma la cartella stessa non viene più usata. |
|
Versione 6.0. Directory del file system che viene usata come repository per i file di immagine comuni a tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Documents\My Pictures. |
|
Directory del file system contenente le directory per i gruppi di programmi comuni visualizzati nel menu Start per tutti gli utenti. Un percorso tipico è C:\Documenti e impostazioni\Tutti gli utenti\Menu Start\Programmi. |
|
Directory del file system che contiene i programmi e le cartelle che vengono visualizzati nel menu Start per tutti gli utenti. Un percorso tipico è C:\Documents and Settings\All Users\Start Menu. |
|
Directory del file system che contiene i programmi che vengono visualizzati nella cartella di avvio per tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Start Menu\Programmi\Startup. |
|
Directory del file system che contiene i modelli disponibili per tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Templates. |
|
Versione 6.0. Directory del file system che viene usata come repository per i file video comuni a tutti gli utenti. Un percorso tipico è C:\Documents and Settings\All Users\Documents\My Videos. |
|
Cartella che rappresenta altri computer nel gruppo di lavoro. |
|
Cartella virtuale che rappresenta Connessioni di rete, che contiene connessioni di rete e di connessione remota. |
|
Cartella virtuale che contiene icone per le applicazioni di Pannello di controllo. |
|
Directory del file system che funge da repository comune per i cookie Internet. Un percorso tipico è C:\Documents and Settings\username\Cookies. |
|
Cartella virtuale che rappresenta il desktop di Windows, la radice dello spazio dei nomi. |
|
La directory del file system usata per archiviare fisicamente gli oggetti file sul desktop (non da confondere con la cartella desktop stessa). Un percorso tipico è C:\Documents and Settings\username\Desktop. |
|
Cartella virtuale che rappresenta Il computer personale, contenente tutto il computer locale: dispositivi di archiviazione, stampanti e Pannello di controllo. La cartella può anche contenere unità di rete mappate. |
|
Directory del file system che funge da repository comune per gli elementi preferiti dell'utente. Un percorso tipico è C:\Documents and Settings\username\Favorites. |
|
Cartella virtuale che contiene i tipi di carattere. Un percorso tipico è C:\Windows\Font. |
|
Directory del file system che funge da repository comune per gli elementi della cronologia Internet. |
|
Cartella virtuale per Internet Explorer. |
|
Versione 4.72. Directory del file system che funge da repository comune per i file Internet temporanei. Un percorso tipico è C:\Documents and Settings\username\Local Settings\Temporary Internet Files. |
|
Versione 5.0. Directory del file system che funge da repository di dati per applicazioni locali (nonroaming). Un percorso tipico è C:\Documents and Settings\username\Local Settings\Application Data. |
|
Versione 6.0. Cartella virtuale che rappresenta l'elemento desktop Documenti personali. Questo valore equivale a CSIDL_PERSONAL. |
|
Directory del file system che funge da repository comune per i file musicali. Un percorso tipico è C:\Documents e Settings\User\My Documents\My Music. |
|
Versione 5.0. Directory del file system che funge da repository comune per i file di immagine. Un percorso tipico è C:\Documents and Settings\username\My Documents\My Pictures. |
|
Versione 6.0. Directory del file system che funge da repository comune per i file video. Un percorso tipico è C:\Documents and Settings\username\My Documents\My Videos. |
|
Directory del file system che contiene gli oggetti collegamento che esistono nella cartella virtuale Risorse di rete. Non è uguale a CSIDL_NETWORK, che rappresenta la radice dello spazio dei nomi di rete. Un percorso tipico è C:\Documents e Settings\username\NetHood. |
|
Cartella virtuale che rappresenta Il quartiere di rete, la radice della gerarchia dello spazio dei nomi di rete. |
|
Versione 6.0. Cartella virtuale che rappresenta l'elemento desktop Documenti personali. Equivale a CSIDL_MYDOCUMENTS. Precedente alla versione 6.0. Directory del file system usata per archiviare fisicamente il repository comune di documenti di un utente. Un percorso tipico è C:\Documents e Settings\username\My Documents. Questa operazione deve essere distinta dalla cartella Documenti personali virtuale nello spazio dei nomi. Per accedere a tale cartella virtuale, usare SHGetFolderLocation, che restituisce ITEMIDLIST per la posizione virtuale oppure fare riferimento alla tecnica descritta in Gestione del file system. |
|
Cartella virtuale contenente stampanti installate. |
|
Directory del file system che contiene gli oggetti collegamento che possono esistere nella cartella virtuale Stampanti. Un percorso tipico è C:\Documents and Settings\username\PrintHood. |
|
Versione 5.0. Cartella del profilo dell'utente. Un percorso tipico è C:\Users\username. Le applicazioni non devono creare file o cartelle a questo livello; devono inserire i dati nelle posizioni a cui fa riferimento CSIDL_APPDATA o CSIDL_LOCAL_APPDATA. Tuttavia, se si sta creando una nuova cartella nota, la radice del profilo a cui fa riferimento CSIDL_PROFILE è appropriata. |
|
Versione 5.0. Cartella Programmi. Un percorso tipico è C:\Programmi. |
|
|
|
Versione 5.0. Cartella per i componenti condivisi da più applicazioni. Un percorso tipico è C:\Programmi\Common. Valido solo per Windows XP. |
|
|
|
Directory del file system che contiene i gruppi di programmi dell'utente ,ovvero le directory del file system stesso. Un percorso tipico è C:\Documents e Settings\username\Start Menu\Programmi. |
|
Directory del file system che contiene collegamenti ai documenti usati più di recente dall'utente. Un percorso tipico è C:\Documents e Settings\username\My Recent Documents. Per creare un collegamento in questa cartella, usare SHAddToRecentDocs. Oltre a creare il collegamento, questa funzione aggiorna l'elenco dei documenti recenti di Shell e aggiunge il collegamento al sottomenu Documenti recenti del menu Start . |
|
Windows Vista. Directory del file system che contiene i dati di risorsa. Un percorso tipico è C:\Windows\Resources. |
|
|
|
Directory del file system contenente le voci di menu Invia a . Un percorso tipico è C:\Documents e Settings\username\SendTo. |
|
Directory del file system contenente le voci di menu Start . Un percorso tipico è C:\Documents and Settings\username\Start Menu. |
|
Directory del file system corrispondente al gruppo di programma di avvio dell'utente. Il sistema avvia questi programmi ogni volta che l'utente associato accede. Un percorso tipico è C:\Documents and Settings\username\Start Menu\Programmi\Startup. |
|
Versione 5.0. Cartella System di Windows. Un percorso tipico è C:\Windows\System32. |
|
|
|
Directory del file system che funge da repository comune per i modelli di documento. Un percorso tipico è C:\Documents and Settings\username\Templates. |
|
Versione 5.0. Directory di Windows o SYSROOT. Corrisponde alle variabili di ambiente %windir% o %SYSTEMROOT%. Un percorso tipico è C:\Windows. |
|
|
|
Versione 5.0. Combinare con un altro CSIDL per forzare la creazione della cartella associata se non esiste. |
|
Combinare con un'altra costante CSIDL per garantire l'espansione delle variabili di ambiente. |
|
Combinare con un'altra costante CSIDL, ad eccezione di CSIDL_FLAG_CREATE, per restituire un percorso di cartella non verificato senza alcun tentativo di creare o inizializzare la cartella. |
|
Combinare con un'altra costante CSIDL per garantire il recupero del percorso di sistema true per la cartella, senza segnaposto alias, ad esempio %USERPROFILE%, restituito da SHGetFolderLocation. Questo flag non ha alcun effetto sui percorsi restituiti da SHGetFolderPath. |
|
|
|
Maschera per qualsiasi valore di flag CSIDL valido. |
Commenti
Questi valori sostituiscono l'uso delle variabili di ambiente per questo scopo. Vengono sostituite a sua volta in Windows Vista e versioni successive dai valori KNOWNFOLDERID .
Un CSIDL viene usato insieme a una delle quattro funzioni shell, SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation e SHGetSpecialFolderPath, per recuperare il percorso o il puntatore di una cartella speciale a un elenco di identificatori di elemento (PIDL).
Combinare CSIDL_FLAG_CREATE con qualsiasi altro CSIDLs, ad eccezione di CSIDL_FLAG_DONT_VERIFY, per forzare la creazione della cartella associata. Gli URL CSID rimanenti corrispondono alle cartelle del file system o alle cartelle virtuali. Dove CSIDL identifica una cartella del file system, viene indicato un percorso comunemente usato come esempio. È possibile usare altri percorsi. È possibile eseguire il mapping di alcuni CSID A una variabile di ambiente %VariableName% equivalente. Gli ID CSID sono tuttavia più affidabili e devono essere usati se possibile.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
Vedi anche