CSIDL

Nota

A partir de Windows Vista, estos valores se han reemplazado por valores KNOWNFOLDERID. Vea ese tema para obtener una lista de las nuevas constantes y sus valores CSIDL correspondientes. Para mayor comodidad, los valores KNOWNFOLDERID correspondientes también se indican aquí para cada valor CSIDL.

El sistema CSIDL se admite en Windows Vista por motivos de compatibilidad. Sin embargo, el nuevo desarrollo debe usar valores KNOWNFOLDERID en lugar de valores CSIDL.

 

Los valores de CSIDL (lista de identificadores de elementos especiales constantes) proporcionan una manera única independiente del sistema de identificar las carpetas especiales usadas con frecuencia por las aplicaciones, pero que pueden no tener el mismo nombre o ubicación en cualquier sistema determinado. Por ejemplo, la carpeta del sistema puede ser "C:\Windows" en un sistema y "C:\Winnt" en otra. Estas constantes se definen en Shlobj.h.

Constante o valor Descripción
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
Versión 5.0. Directorio del sistema de archivos que se usa para almacenar herramientas administrativas para un usuario individual. MMC guardará las consolas personalizadas en este directorio y se desplazará con el usuario.
CSIDL_ALTSTARTUP
FOLDERID_Startup
Directorio del sistema de archivos que corresponde al grupo de programas de inicio no localizado del usuario. Este valor se reconoce en Windows Vista por compatibilidad con versiones anteriores, pero la carpeta ya no existe.
CSIDL_APPDATA
FOLDERID_RoamingAppData
Versión 4.71. Directorio del sistema de archivos que actúa como repositorio común para datos específicos de la aplicación. Una ruta de acceso típica es C:\Documents y Configuración\username\Application Data.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
Carpeta virtual que contiene los objetos de la Papelera de reciclaje del usuario.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
Versión 6.0. Directorio del sistema de archivos que actúa como área de almacenamiento para los archivos en espera para grabarse en un CD. Una ruta de acceso típica es C:\Documents and Configuración\username\Local Configuración\Application Data\Microsoft\CD Burning.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Versión 5.0. Directorio del sistema de archivos que contiene herramientas administrativas para todos los usuarios del equipo.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
Directorio del sistema de archivos que corresponde al grupo de programas de inicio no localizado para todos los usuarios. Este valor se reconoce en Windows Vista por compatibilidad con versiones anteriores, pero la carpeta ya no existe.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
Versión 5.0. Directorio del sistema de archivos que contiene datos de aplicación para todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\Todos los usuarios\Datos de la aplicación. Esta carpeta se usa para los datos de la aplicación que no son específicos del usuario. Por ejemplo, una aplicación puede almacenar un diccionario de revisión ortográfica, una base de datos de imágenes prediseñadas o un archivo de registro en la carpeta CSIDL_COMMON_APPDATA. Esta información no se desplazará y estará disponible para cualquier usuario que use el equipo.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
Directorio del sistema de archivos que contiene los archivos y carpetas que aparecen en el escritorio para todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\Todos los usuarios\Escritorio.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
Directorio del sistema de archivos que contiene documentos que son comunes a todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\All Users\Documents.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
Directorio del sistema de archivos que actúa como repositorio común para los elementos favoritos comunes a todos los usuarios.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
Versión 6.0. Directorio del sistema de archivos que actúa como repositorio para los archivos de música comunes a todos los usuarios. Una ruta de acceso típica es C:\Documents and Configuración\All Users\Documents\My Música.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Este valor se reconoce en Windows Vista por compatibilidad con versiones anteriores, pero la carpeta en sí ya no se usa.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
Versión 6.0. Directorio del sistema de archivos que actúa como repositorio para los archivos de imágenes comunes a todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\Todos los usuarios\Documentos\Mis imágenes.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
Directorio del sistema de archivos que contiene los directorios de los grupos de programas comunes que aparecen en el menú Inicio para todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\Todos los usuarios\Menú Inicio\Programas.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
Directorio del sistema de archivos que contiene los programas y las carpetas que aparecen en el menú Inicio para todos los usuarios. Una ruta de acceso típica es C:\Documents and Configuración\All Users\Start Menu.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
Directorio del sistema de archivos que contiene los programas que aparecen en la carpeta Inicio para todos los usuarios. Una ruta de acceso típica es C:\Documents and Configuración\All Users\Start Menu\Programs\Startup.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
Directorio del sistema de archivos que contiene las plantillas que están disponibles para todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\Todos los usuarios\Templates.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
Versión 6.0. Directorio del sistema de archivos que actúa como repositorio para los archivos de vídeo comunes a todos los usuarios. Una ruta de acceso típica es C:\Documents y Configuración\Todos los usuarios\Documentos\Mis vídeos.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
Carpeta que representa otros equipos del grupo de trabajo.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
La carpeta virtual que representa Conexiones de red, que contiene conexiones de red y acceso telefónico.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
Carpeta virtual que contiene iconos para las aplicaciones de Panel de control.
CSIDL_COOKIES
FOLDERID_Cookies
Directorio del sistema de archivos que actúa como repositorio común para las cookies de Internet. Una ruta de acceso típica es C:\Documents y Configuración\username\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
La carpeta virtual que representa el Windows escritorio, la raíz del espacio de nombres.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
Directorio del sistema de archivos usado para almacenar físicamente objetos de archivo en el escritorio (no confundirse con la propia carpeta de escritorio). Una ruta de acceso típica es C:\Documents y Configuración\username\Desktop.
CSIDL_DRIVES
FOLDERID_ComputerFolder
La carpeta virtual que representa Mi equipo, que contiene todo en el equipo local: dispositivos de almacenamiento, impresoras y Panel de control. La carpeta también puede contener unidades de red asignadas.
CSIDL_FAVORITES
FOLDERID_Favorites
Directorio del sistema de archivos que actúa como repositorio común para los elementos favoritos del usuario. Una ruta de acceso típica es C:\Documents y Configuración\username\Favorites.
CSIDL_FONTS
FOLDERID_Fonts
Carpeta virtual que contiene fuentes. Una ruta de acceso típica es C:\Windows\Fonts.
CSIDL_HISTORY
FOLDERID_History
Directorio del sistema de archivos que actúa como repositorio común para los elementos de historial de Internet.
CSIDL_INTERNET
FOLDERID_InternetFolder
Una carpeta virtual para Internet Explorer.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
Versión 4.72. Directorio del sistema de archivos que actúa como repositorio común para archivos temporales de Internet. Una ruta de acceso típica es C:\Documents and Configuración\username\Local Configuración\Temporary Internet Files.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
Versión 5.0. Directorio del sistema de archivos que actúa como repositorio de datos para aplicaciones locales (no desagrupando). Una ruta de acceso típica es C:\Documents and Configuración\username\Local Configuración\Application Data.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Versión 6.0. Carpeta virtual que representa el elemento de escritorio Mis documentos. Este valor es equivalente a CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
Directorio del sistema de archivos que actúa como repositorio común para archivos de música. Una ruta de acceso típica es C:\Documents and Configuración\User\My Documents\My Música.
CSIDL_MYPICTURES
FOLDERID_Pictures
Versión 5.0. Directorio del sistema de archivos que actúa como repositorio común para los archivos de imagen. Una ruta de acceso típica es C:\Documents and Configuración\username\My Documents\My Pictures.
CSIDL_MYVIDEO
FOLDERID_Videos
Versión 6.0. Directorio del sistema de archivos que actúa como repositorio común para los archivos de vídeo. Una ruta de acceso típica es C:\Documents and Configuración\username\My Documents\My Videos.
CSIDL_NETHOOD
FOLDERID_NetHood
Directorio del sistema de archivos que contiene los objetos de vínculo que pueden existir en la carpeta virtual Mis sitios de red. No es lo mismo que CSIDL_NETWORK, que representa la raíz del espacio de nombres de red. Una ruta de acceso típica es C:\Documents y Configuración\username\NetHood.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Una carpeta virtual que representa Network Neighborhood, la raíz de la jerarquía del espacio de nombres de red.
CSIDL_PERSONAL
FOLDERID_Documents
Versión 6.0. Carpeta virtual que representa el elemento de escritorio Mis documentos. Esto equivale a CSIDL_MYDOCUMENTS.
Anterior a la versión 6.0. Directorio del sistema de archivos que se usa para almacenar físicamente el repositorio común de documentos de un usuario. Una ruta de acceso típica es C:\Documents y Configuración\username\My Documents. Debe distinguirse de la carpeta Mis documentos virtual en el espacio de nombres . Para acceder a esa carpeta virtual, use SHGetFolderLocation, que devuelve ITEMIDLIST para la ubicación virtual, o consulte la técnica descrita en Administración del sistema de archivos.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
Carpeta virtual que contiene impresoras instaladas.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
Directorio del sistema de archivos que contiene los objetos de vínculo que pueden existir en la carpeta virtual Impresoras. Una ruta de acceso típica es C:\Documents y Configuración\username\PrintHood.
CSIDL_PROFILE
FOLDERID_Profile
Versión 5.0. Carpeta de perfil del usuario. Una ruta de acceso típica es C:\Users\username. Las aplicaciones no deben crear archivos ni carpetas en este nivel; deben colocar sus datos en las ubicaciones a las que hace referencia CSIDL_APPDATA o CSIDL_LOCAL_APPDATA. Sin embargo, si va a crear una nueva carpeta conocida, la raíz del perfil a la que hace referencia CSIDL_PROFILE es adecuada.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Versión 5.0. Carpeta Archivos de programa. Una ruta de acceso típica es C:\Archivos de programa.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Versión 5.0. Una carpeta para los componentes que las aplicaciones comparten. Una ruta de acceso típica es C:\Archivos de programa\Common. Válido solo para Windows XP.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
Directorio del sistema de archivos que contiene los grupos de programas del usuario (que son directorios del sistema de archivos). Una ruta de acceso típica es C:\Documents and Configuración\username\Start Menu\Programs.
CSIDL_RECENT
FOLDERID_Recent
Directorio del sistema de archivos que contiene accesos directos a los documentos usados por el usuario más recientemente. Una ruta de acceso típica es C:\Documents and Configuración\username\My Recent Documents. Para crear un acceso directo en esta carpeta, use SHAddToRecentDocs. Además de crear el acceso directo, esta función actualiza la lista de documentos recientes del Shell y agrega el acceso directo al submenú Mis documentos recientes del menú Inicio .
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista. Directorio del sistema de archivos que contiene datos de recursos. Una ruta de acceso típica es C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
Directorio del sistema de archivos que contiene elementos de menú Enviar a . Una ruta de acceso típica es C:\Documents y Configuración\username\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
Directorio del sistema de archivos que contiene elementos de menú Inicio . Una ruta de acceso típica es C:\Documents and Configuración\username\Start Menu.
CSIDL_STARTUP
FOLDERID_Startup
Directorio del sistema de archivos que corresponde al grupo de programas de inicio del usuario. El sistema inicia estos programas cada vez que el usuario asociado inicia sesión. Una ruta de acceso típica es C:\Documents and Configuración\username\Start Menu\Programs\Startup.
CSIDL_SYSTEM
FOLDERID_System
Versión 5.0. Carpeta Sistema de Windows. Una ruta de acceso típica es C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
Directorio del sistema de archivos que actúa como repositorio común para las plantillas de documento. Una ruta de acceso típica es C:\Documents y Configuración\username\Templates.
CSIDL_WINDOWS
FOLDERID_Windows
Versión 5.0. Directorio de Windows o SYSROOT. Corresponde a las variables de entorno %windir% o %SYSTEMROOT%. Una ruta de acceso típica es C:\Windows.
Marcas
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Versión 5.0. Combine con otro CSIDL para forzar la creación de la carpeta asociada si no existe.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Combine con otra constante CSIDL para garantizar la expansión de variables de entorno.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
Combine con otra constante CSIDL, excepto por CSIDL_FLAG_CREATE, para devolver una ruta de acceso de carpeta sin comprobar sin intentar crear ni inicializar la carpeta.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
Combine con otra constante CSIDL para garantizar la recuperación de la ruta de acceso del sistema verdadera para la carpeta, sin ningún marcador de posición con alias, como %USERPROFILE%, devuelto por SHGetFolderLocation. Esta marca no tiene ningún efecto en las rutas de acceso devueltas por SHGetFolderPath.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
Máscara para cualquier valor de marca CSIDL válido.

Observaciones

Estos valores reemplazan el uso de variables de entorno para este fin. A su vez, se sustituyen en Windows Vista y versiones posteriores por los valores KNOWNFOLDERID.

Un CSIDL se usa junto con una de las cuatro funciones de Shell, SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation y SHGetSpecialFolderPath, para recuperar la ruta de acceso o el puntero de una carpeta especial a una lista de identificadores de elemento (PIDL).

Combine CSIDL_FLAG_CREATE con cualquiera de los demás CSIDL, excepto por CSIDL_FLAG_DONT_VERIFY, para forzar la creación de la carpeta asociada. Los CSIDL restantes corresponden a carpetas del sistema de archivos o carpetas virtuales. Cuando csiDL identifica una carpeta del sistema de archivos, se proporciona una ruta de acceso usada habitualmente como ejemplo. Se pueden usar otras rutas de acceso. Algunos CSIDL se pueden asignar a una variable de entorno %VariableName% equivalente. Sin embargo, los CSIDL son más confiables y se deben usar si es posible.

Requisitos

Requisito Value
Encabezado
Shlobj.h

Consulte también

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG