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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Carpeta virtual que contiene los objetos de la Papelera de reciclaje del usuario. |
|
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. |
|
Versión 5.0. Directorio del sistema de archivos que contiene herramientas administrativas para todos los usuarios del equipo. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Directorio del sistema de archivos que actúa como repositorio común para elementos favoritos comunes a todos los usuarios. |
|
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. |
|
Este valor se reconoce en Windows Vista por compatibilidad con versiones anteriores, pero la carpeta en sí ya no se usa. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Carpeta que representa otros equipos del grupo de trabajo. |
|
Carpeta virtual que representa Conexiones de red, que contiene conexiones de red y acceso telefónico. |
|
Carpeta virtual que contiene iconos para las aplicaciones de Panel de control. |
|
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. |
|
Carpeta virtual que representa el escritorio de Windows, la raíz del espacio de nombres. |
|
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. |
|
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. |
|
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. |
|
Carpeta virtual que contiene fuentes. Una ruta de acceso típica es C:\Windows\Fonts. |
|
Directorio del sistema de archivos que actúa como repositorio común para los elementos de historial de Internet. |
|
Una carpeta virtual para Internet Explorer. |
|
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. |
|
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. |
|
Versión 6.0. Carpeta virtual que representa el elemento de escritorio Mis documentos. Este valor es equivalente a CSIDL_PERSONAL. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Carpeta virtual que representa El vecindario de red, la raíz de la jerarquía del espacio de nombres de red. |
|
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. |
|
Carpeta virtual que contiene impresoras instaladas. |
|
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. |
|
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. |
|
Versión 5.0. Carpeta Archivos de programa. Una ruta de acceso típica es C:\Archivos de programa. |
|
|
|
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. |
|
|
|
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. |
|
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 . |
|
Windows Vista. Directorio del sistema de archivos que contiene datos de recursos. Una ruta de acceso típica es C:\Windows\Resources. |
|
|
|
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. |
|
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. |
|
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. |
|
Versión 5.0. Carpeta Sistema de Windows. Una ruta de acceso típica es C:\Windows\System32. |
|
|
|
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. |
|
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. |
|
|
|
Versión 5.0. Combine con otro CSIDL para forzar la creación de la carpeta asociada si no existe. |
|
Combine con otra constante CSIDL para garantizar la expansión de variables de entorno. |
|
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. |
|
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. |
|
|
|
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 |
|
Consulte también