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