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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
A pasta virtual que contém os objetos na Lixeira do usuário. |
|
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. |
|
Versão 5.0. O diretório do sistema de arquivos que contém ferramentas administrativas para todos os usuários do computador. |
|
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. |
|
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. |
|
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. |
|
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. |
|
O diretório do sistema de arquivos que serve como um repositório comum para itens favoritos comuns a todos os usuários. |
|
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. |
|
Esse valor é reconhecido no Windows Vista para compatibilidade com versões anteriores, mas a pasta em si não é mais usada. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
A pasta que representa outros computadores em seu grupo de trabalho. |
|
A pasta virtual que representa conexões de rede, que contém conexões de rede e discagem. |
|
A pasta virtual que contém ícones para os aplicativos Painel de Controle. |
|
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. |
|
A pasta virtual que representa a área de trabalho do Windows, a raiz do namespace. |
|
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. |
|
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. |
|
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. |
|
Uma pasta virtual que contém fontes. Um caminho típico é C:\Windows\Fonts. |
|
O diretório do sistema de arquivos que serve como um repositório comum para itens de histórico da Internet. |
|
Uma pasta virtual para Explorer da Internet. |
|
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. |
|
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. |
|
Versão 6.0. A pasta virtual que representa o item da área de trabalho Meus Documentos. Esse valor é equivalente a CSIDL_PERSONAL. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Uma pasta virtual que representa o Network Neighborhood, a raiz da hierarquia de namespace de rede. |
|
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. |
|
A pasta virtual que contém impressoras instaladas. |
|
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. |
|
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. |
|
Versão 5.0. A pasta Arquivos de Programas. Um caminho típico é C:\Arquivos de Programas. |
|
|
|
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. |
|
|
|
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. |
|
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 . |
|
Windows Vista. O diretório do sistema de arquivos que contém dados do recurso. Um caminho típico é C:\Windows\Resources. |
|
|
|
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. |
|
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. |
|
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. |
|
Versão 5.0. A pasta System do Windows. Um caminho típico é C:\Windows\System32. |
|
|
|
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. |
|
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. |
|
|
|
Versão 5.0. Combine com outro CSIDL para forçar a criação da pasta associada se ela não existir. |
|
Combine com outra constante CSIDL para garantir a expansão de variáveis de ambiente. |
|
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. |
|
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. |
|
|
|
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 |
|
Confira também