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 and Settings\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 Settings\username\Local Settings\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 and Settings\All Users\Application Data. 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 and Settings\All Users\Desktop.
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 and Settings\All Users\Documents.
CSIDL_COMMON_FAVORITES FOLDERID_Favorites	Directorio del sistema de archivos que actúa como repositorio común para 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 Settings\All Users\Documents\My Music.
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 and Settings\All Users\Documents\My Pictures.
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 and Settings\All Users\Start Menu\Programs.
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 Settings\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 Settings\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 and Settings\All Users\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 and Settings\All Users\Documents\My Videos.
CSIDL_COMPUTERSNEARME FOLDERID_NetworkFolder	Carpeta que representa otros equipos del grupo de trabajo.
CSIDL_CONNECTIONS FOLDERID_ConnectionsFolder	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 and Settings\username\Cookies.
CSIDL_DESKTOP FOLDERID_Desktop	Carpeta virtual que representa el escritorio de Windows, 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 and Settings\username\Desktop.
CSIDL_DRIVES FOLDERID_ComputerFolder	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 and Settings\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 Settings\username\Local Settings\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 (que no son de enlace). Una ruta de acceso típica es C:\Documents and Settings\username\Local Settings\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 Settings\User\My Documents\My Music.
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 Settings\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 archivos de vídeo. Una ruta de acceso típica es C:\Documents and Settings\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 and Settings\username\NetHood.
CSIDL_NETWORK FOLDERID_NetworkFolder	Carpeta virtual que representa El vecindario de red, 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 and Settings\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 and Settings\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 Settings\username\Start Menu\Programs.
CSIDL_RECENT FOLDERID_Recent	Directorio del sistema de archivos que contiene accesos directos a los documentos usados más recientemente por el usuario. Una ruta de acceso típica es C:\Documents and Settings\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 and Settings\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 Settings\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 Settings\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 plantillas de documento. Una ruta de acceso típica es C:\Documents and Settings\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 no comprobada 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, libre de cualquier 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.

Comentarios

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

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

Combine CSIDL_FLAG_CREATE con cualquiera de las 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. Donde 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, las 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