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
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
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.
CSIDL_ALTSTARTUP
FOLDERID_Startup
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ù.
CSIDL_APPDATA
FOLDERID_RoamingAppData
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.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
Cartella virtuale contenente gli oggetti nel Cestino dell'utente.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
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.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Versione 5.0. Directory del file system che contiene strumenti amministrativi per tutti gli utenti del computer.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
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ù.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
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.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
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.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
Directory del file system che contiene documenti comuni a tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Documents.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
Directory del file system che funge da repository comune per gli elementi preferiti comuni a tutti gli utenti.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
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.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Questo valore viene riconosciuto in Windows Vista per la compatibilità con le versioni precedenti, ma la cartella stessa non viene più usata.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
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.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
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.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
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.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
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.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
Directory del file system che contiene i modelli disponibili per tutti gli utenti. Un percorso tipico è C:\Documents e Settings\All Users\Templates.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
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.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
Cartella che rappresenta altri computer nel gruppo di lavoro.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
Cartella virtuale che rappresenta Connessioni di rete, che contiene connessioni di rete e di connessione remota.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
Cartella virtuale che contiene icone per le applicazioni di Pannello di controllo.
CSIDL_COOKIES
FOLDERID_Cookies
Directory del file system che funge da repository comune per i cookie Internet. Un percorso tipico è C:\Documents and Settings\username\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
Cartella virtuale che rappresenta il desktop di Windows, la radice dello spazio dei nomi.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
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.
CSIDL_DRIVES
FOLDERID_ComputerFolder
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.
CSIDL_FAVORITES
FOLDERID_Favorites
Directory del file system che funge da repository comune per gli elementi preferiti dell'utente. Un percorso tipico è C:\Documents and Settings\username\Favorites.
CSIDL_FONTS
FOLDERID_Fonts
Cartella virtuale che contiene i tipi di carattere. Un percorso tipico è C:\Windows\Font.
CSIDL_HISTORY
FOLDERID_History
Directory del file system che funge da repository comune per gli elementi della cronologia Internet.
CSIDL_INTERNET
FOLDERID_InternetFolder
Cartella virtuale per Internet Explorer.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
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.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
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.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Versione 6.0. Cartella virtuale che rappresenta l'elemento desktop Documenti personali. Questo valore equivale a CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
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.
CSIDL_MYPICTURES
FOLDERID_Pictures
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.
CSIDL_MYVIDEO
FOLDERID_Videos
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.
CSIDL_NETHOOD
FOLDERID_NetHood
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.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Cartella virtuale che rappresenta Il quartiere di rete, la radice della gerarchia dello spazio dei nomi di rete.
CSIDL_PERSONAL
FOLDERID_Documents
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.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
Cartella virtuale contenente stampanti installate.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
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.
CSIDL_PROFILE
FOLDERID_Profile
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.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Versione 5.0. Cartella Programmi. Un percorso tipico è C:\Programmi.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Versione 5.0. Cartella per i componenti condivisi da più applicazioni. Un percorso tipico è C:\Programmi\Common. Valido solo per Windows XP.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
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.
CSIDL_RECENT
FOLDERID_Recent
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 .
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista. Directory del file system che contiene i dati di risorsa. Un percorso tipico è C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
Directory del file system contenente le voci di menu Invia a . Un percorso tipico è C:\Documents e Settings\username\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
Directory del file system contenente le voci di menu Start . Un percorso tipico è C:\Documents and Settings\username\Start Menu.
CSIDL_STARTUP
FOLDERID_Startup
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.
CSIDL_SYSTEM
FOLDERID_System
Versione 5.0. Cartella System di Windows. Un percorso tipico è C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
Directory del file system che funge da repository comune per i modelli di documento. Un percorso tipico è C:\Documents and Settings\username\Templates.
CSIDL_WINDOWS
FOLDERID_Windows
Versione 5.0. Directory di Windows o SYSROOT. Corrisponde alle variabili di ambiente %windir% o %SYSTEMROOT%. Un percorso tipico è C:\Windows.
Flag
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Versione 5.0. Combinare con un altro CSIDL per forzare la creazione della cartella associata se non esiste.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Combinare con un'altra costante CSIDL per garantire l'espansione delle variabili di ambiente.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
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.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
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.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
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
Shlobj.h

Vedi anche

SHGetFolderLocation

Shgetfolderpath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG