Compartilhar via


CSIDL

Observação

A partir do Windows Vista, esses valores foram substituídos por valores KNOWNFOLDERID . Consulte esse tópico para obter uma lista das novas constantes e seus valores CSIDL correspondentes. Para sua conveniência, os valores KNOWNFOLDERID correspondentes também são indicados aqui para cada valor CSIDL.

O sistema CSIDL tem suporte no Windows Vista por motivos de compatibilidade. No entanto, o novo desenvolvimento deve usar valores KNOWNFOLDERID em vez de valores CSIDL.

 

Os valores csidl (lista de IDs de item especial constante) fornecem uma maneira exclusiva independente do sistema de identificar pastas especiais usadas com frequência por aplicativos, mas que podem não ter o mesmo nome ou local em qualquer sistema específico. Por exemplo, a pasta do sistema pode ser "C:\Windows" em um sistema e "C:\Winnt" em outro. Essas constantes são definidas em Shlobj.h.

Constante/valor Descrição
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
Versão 5.0. O diretório de sistema de arquivos que é usado para armazenar ferramentas administrativas para um usuário individual. O MMC salvará consoles personalizados nesse diretório e ele usará roaming com o usuário.
CSIDL_ALTSTARTUP
FOLDERID_Startup
O diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização nãocalizado do usuário. Esse valor é reconhecido no Windows Vista para compatibilidade com versões anteriores, mas a própria pasta não existe mais.
CSIDL_APPDATA
FOLDERID_RoamingAppData
Versão 4.71. O diretório do sistema de arquivos que serve como um repositório comum para dados específicos do aplicativo. Um caminho típico é C:\Documents and Settings\username\Application Data.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
A pasta virtual que contém os objetos na Lixeira do usuário.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
Versão 6.0. O diretório do sistema de arquivos que atua como uma área de preparo para os arquivos aguardando para serem gravados em um CD. Um caminho típico é C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Versão 5.0. O diretório do sistema de arquivos que contém ferramentas administrativas para todos os usuários do computador.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
O diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização nãocalizado para todos os usuários. Esse valor é reconhecido no Windows Vista para compatibilidade com versões anteriores, mas a própria pasta não existe mais.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
Versão 5.0. O diretório do sistema de arquivos que contém dados do aplicativo para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Application Data. Essa pasta é usada para dados de aplicativo que não são específicos do usuário. Por exemplo, um aplicativo pode armazenar um dicionário marcar ortográfico, um banco de dados de clip-art ou um arquivo de log na pasta CSIDL_COMMON_APPDATA. Essas informações não serão usadas e estarão disponíveis para qualquer pessoa que use o computador.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
O diretório do sistema de arquivos que contém os arquivos e pastas que aparecem na área de trabalho para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Desktop.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
O diretório do sistema de arquivos que contém os documentos que são comuns para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Documents.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
O diretório do sistema de arquivos que serve como um repositório comum para itens favoritos comuns a todos os usuários.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
Versão 6.0. O diretório do sistema de arquivos que serve como um repositório para os arquivos de música comuns para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Documents\My Music.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Esse valor é reconhecido no Windows Vista para compatibilidade com versões anteriores, mas a pasta em si não é mais usada.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
Versão 6.0. O diretório do sistema de arquivos que serve como um repositório para os arquivos de imagem comuns para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Documents\My Pictures.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
O diretório do sistema de arquivos que contém os diretórios dos grupos de programas comuns que aparecem no menu Iniciar para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu\Programs.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
O diretório do sistema de arquivos que contém os programas e as pastas que aparecem no menu Iniciar para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
O diretório do sistema de arquivos que contém os programas que aparecem na pasta Inicialização para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu\Programs\Startup.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
O diretório do sistema de arquivos que contém os modelos que estão disponíveis para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Templates.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
Versão 6.0. O diretório do sistema de arquivos que serve como um repositório para os arquivos de vídeo comuns para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Documents\My Videos.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
A pasta que representa outros computadores em seu grupo de trabalho.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
A pasta virtual que representa conexões de rede, que contém conexões de rede e discagem.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
A pasta virtual que contém ícones para os aplicativos Painel de Controle.
CSIDL_COOKIES
FOLDERID_Cookies
O diretório do sistema de arquivos que serve como um repositório comum para cookies da Internet. Um caminho típico é C:\Documents and Settings\username\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
A pasta virtual que representa a área de trabalho do Windows, a raiz do namespace.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
O diretório do sistema de arquivos usado para armazenar fisicamente objetos de arquivo na área de trabalho (não deve ser confundido com a própria pasta da área de trabalho). Um caminho típico é C:\Documents and Settings\username\Desktop.
CSIDL_DRIVES
FOLDERID_ComputerFolder
A pasta virtual que representa Meu Computador, contendo tudo no computador local: dispositivos de armazenamento, impressoras e Painel de Controle. A pasta também pode conter unidades de rede mapeadas.
CSIDL_FAVORITES
FOLDERID_Favorites
O diretório do sistema de arquivos que serve como um repositório comum para os itens favoritos do usuário. Um caminho típico é C:\Documents and Settings\username\Favorites.
CSIDL_FONTS
FOLDERID_Fonts
Uma pasta virtual que contém fontes. Um caminho típico é C:\Windows\Fonts.
CSIDL_HISTORY
FOLDERID_History
O diretório do sistema de arquivos que serve como um repositório comum para itens de histórico da Internet.
CSIDL_INTERNET
FOLDERID_InternetFolder
Uma pasta virtual para Explorer da Internet.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
Versão 4.72. O diretório do sistema de arquivos que serve como um repositório comum para arquivos temporários da Internet. Um caminho típico é C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
Versão 5.0. O diretório do sistema de arquivos que serve como um repositório de dados para aplicativos locais (não desenraização). Um caminho típico é C:\Documents and Settings\username\Local Settings\Application Data.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Versão 6.0. A pasta virtual que representa o item da área de trabalho Meus Documentos. Esse valor é equivalente a CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
O diretório do sistema de arquivos que serve como um repositório comum para arquivos de música. Um caminho típico é C:\Documents and Settings\User\My Documents\My Music.
CSIDL_MYPICTURES
FOLDERID_Pictures
Versão 5.0. O diretório do sistema de arquivos que serve como um repositório comum para arquivos de imagem. Um caminho típico é C:\Documents and Settings\username\My Documents\My Pictures.
CSIDL_MYVIDEO
FOLDERID_Videos
Versão 6.0. O diretório do sistema de arquivos que serve como um repositório comum para arquivos de vídeo. Um caminho típico é C:\Documents and Settings\username\My Documents\My Videos.
CSIDL_NETHOOD
FOLDERID_NetHood
Um diretório do sistema de arquivos que contém os objetos de link que podem existir na pasta virtual Meus Locais de Rede. Não é o mesmo que CSIDL_NETWORK, que representa a raiz do namespace de rede. Um caminho típico é C:\Documents and Settings\username\NetHood.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Uma pasta virtual que representa o Network Neighborhood, a raiz da hierarquia de namespace de rede.
CSIDL_PERSONAL
FOLDERID_Documents
Versão 6.0. A pasta virtual que representa o item da área de trabalho Meus Documentos. Isso é equivalente a CSIDL_MYDOCUMENTS.
Anterior à versão 6.0. O diretório do sistema de arquivos usado para armazenar fisicamente o repositório comum de documentos de um usuário. Um caminho típico é C:\Documents and Settings\username\My Documents. Isso deve ser diferenciado da pasta Virtual Meus Documentos no namespace . Para acessar essa pasta virtual, use SHGetFolderLocation, que retorna ITEMIDLIST para o local virtual, ou consulte a técnica descrita em Gerenciando o sistema de arquivos.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
A pasta virtual que contém impressoras instaladas.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
O diretório do sistema de arquivos que contém os objetos de link que podem existir na pasta virtual Impressoras. Um caminho típico é C:\Documents and Settings\username\PrintHood.
CSIDL_PROFILE
FOLDERID_Profile
Versão 5.0. A pasta do perfil do usuário. Um caminho típico é C:\Users\username. Os aplicativos não devem criar arquivos ou pastas neste nível; eles devem colocar seus dados nos locais referenciados por CSIDL_APPDATA ou CSIDL_LOCAL_APPDATA. No entanto, se você estiver criando uma nova Pasta Conhecida, a raiz do perfil referenciada por CSIDL_PROFILE será apropriada.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Versão 5.0. A pasta Arquivos de Programas. Um caminho típico é C:\Arquivos de Programas.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Versão 5.0. Uma pasta de componentes que são compartilhados entre aplicativos. Um caminho típico é C:\Program Files\Common. Válido somente para Windows XP.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
O diretório do sistema de arquivos que contém os grupos de programas do usuário (que são diretórios do sistema de arquivos). Um caminho típico é C:\Documents and Settings\username\Start Menu\Programs.
CSIDL_RECENT
FOLDERID_Recent
O diretório do sistema de arquivos que contém atalhos para os documentos usados mais recentemente pelo usuário. Um caminho típico é C:\Documents and Settings\username\My Recent Documents. Para criar um atalho nessa pasta, use SHAddToRecentDocs. Além de criar o atalho, essa função atualiza a lista de documentos recentes do Shell e adiciona o atalho ao submenu Meus Documentos Recentes do menu Iniciar .
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista. O diretório do sistema de arquivos que contém dados do recurso. Um caminho típico é C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
O diretório do sistema de arquivos que contém itens de menu Enviar para . Um caminho típico é C:\Documents and Settings\username\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
O diretório do sistema de arquivos que contém itens de menu Iniciar . Um caminho típico é C:\Documents and Settings\username\Start Menu.
CSIDL_STARTUP
FOLDERID_Startup
O diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização do usuário. O sistema inicia esses programas sempre que o usuário associado faz logon. Um caminho típico é C:\Documents and Settings\username\Start Menu\Programs\Startup.
CSIDL_SYSTEM
FOLDERID_System
Versão 5.0. A pasta System do Windows. Um caminho típico é C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
O diretório do sistema de arquivos que serve como um repositório comum para modelos de documento. Um caminho típico é C:\Documents and Settings\username\Templates.
CSIDL_WINDOWS
FOLDERID_Windows
Versão 5.0. O diretório do Windows ou SYSROOT. Isso corresponde às variáveis de ambiente %windir% ou %SYSTEMROOT%. Um caminho típico é C:\Windows.
Sinalizadores
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Versão 5.0. Combine com outro CSIDL para forçar a criação da pasta associada se ela não existir.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Combine com outra constante CSIDL para garantir a expansão de variáveis de ambiente.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
Combine com outra constante CSIDL, exceto CSIDL_FLAG_CREATE, para retornar um caminho de pasta não verificado sem nenhuma tentativa de criar ou inicializar a pasta.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
Combine com outra constante CSIDL para garantir a recuperação do caminho do sistema verdadeiro para a pasta, livre de espaços reservados com alias, como %USERPROFILE%, retornado por SHGetFolderLocation. Esse sinalizador não tem efeito sobre os caminhos retornados por SHGetFolderPath.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
Uma máscara para qualquer valor de sinalizador CSIDL válido.

Comentários

Esses valores substituem o uso de variáveis de ambiente para essa finalidade. Eles, por sua vez, são substituídos no Windows Vista e posteriormente pelos valores KNOWNFOLDERID .

Um CSIDL é usado em conjunto com uma das quatro funções do Shell, SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation e SHGetSpecialFolderPath, para recuperar o caminho ou o ponteiro de uma pasta especial para uma PIDL (lista de identificadores de item).

Combine CSIDL_FLAG_CREATE com qualquer uma das outras CSIDLs, exceto CSIDL_FLAG_DONT_VERIFY, para forçar a criação da pasta associada. As CSIDLs restantes correspondem a pastas do sistema de arquivos ou pastas virtuais. Quando o CSIDL identifica uma pasta do sistema de arquivos, um caminho comumente usado é fornecido como um exemplo. Outros caminhos podem ser usados. Algumas CSIDLs podem ser mapeadas para uma variável de ambiente %VariableName% equivalente. As CSIDLs são mais confiáveis, no entanto, e devem ser usadas, se possível.

Requisitos

Requisito Valor
parâmetro
Shlobj.h

Confira também

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

Shgetspecialfolderpath

KNOWN_FOLDER_FLAG