Variáveis de ambiente reconhecidas
Ao usar os arquivos XML MigDocs.xml, MigApp.xml e MigUser.xml, você pode usar variáveis de ambiente para identificar pastas que possam ser diferentes em computadores diferentes. Valores de CSIDL (lista de IDs de itens especiais constantes) fornecem uma maneira de identificar pastas que os aplicativos costumam usar com frequência, mas que talvez não tenham o mesmo nome ou localização em nenhum computador específico. Por exemplo, a pasta de documentos pode ser C:\Users\<Nome do usuário>\My Documents em um computador e C:\Documents and Settings em outro computador. Você pode usar o caractere curinga de asterisco (*) nos arquivos MigUser.xml, MigApp.xml e MigDoc.xml. Porém, não pode usar os caracteres curinga de asterisco (*) no arquivoConfig.xml.
Neste tópico
Variáveis que são processadas para o sistema operacional e no contexto de cada usuário
Variáveis que só são reconhecidas no contexto do usuário
Variáveis que são processadas para o sistema operacional e no contexto de cada usuário
Você pode usar estas variáveis nas seções dos arquivos .xml com context=UserAndSystem, context=User e context=System.
| Variável | Explicação | |||
|---|---|---|---|---|
|
ALLUSERSAPPDATA |
Igual a CSIDL_COMMON_APPDATA. |
|||
|
ALLUSERSPROFILE |
Faz referência a %PROFILESFOLDER%\Public or %PROFILESFOLDER%\all users. |
|||
|
COMMONPROGRAMFILES |
Igual a CSIDL_PROGRAM_FILES_COMMON. |
|||
|
COMMONPROGRAMFILES(X86) |
Faz referência à pasta C:\Arquivos de Programas (x86)\Common Files em sistemas de 64 bits. |
|||
|
CSIDL_COMMON_ADMINTOOLS |
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 |
O diretório do sistema de arquivos que corresponde ao grupo de programas de Inicialização não localizado para todos os usuários. |
|||
|
CSIDL_COMMON_APPDATA |
O diretório do sistema de arquivos que contém dados de aplicativos para todos os usuários. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows® 8 é C:\ProgramData. |
|||
|
CSIDL_COMMON_DESKTOPDIRECTORY |
O diretório do sistema de arquivos que contém arquivos e pastas que aparecem na área de trabalho de todos os usuários. Um caminho típico do Windows® XP é C:\Documents and Settings\All Users\Desktop. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\Público\Área de Trabalho. |
|||
|
CSIDL_COMMON_DOCUMENTS |
O diretório do sistema de arquivos que contém documentos comuns a todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Documentos. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\Público\Documentos. |
|||
|
CSIDL_COMMON_FAVORITES |
O diretório do sistema de arquivos que serve como repositório comum para favoritos que são comuns a todos os usuários. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\Público\Favoritos. |
|||
|
CSIDL_COMMON_MUSIC |
O diretório do sistema de arquivos que serve como repositório para arquivos de música que são comuns a todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Documentos\Minhas Músicas. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\Público\Músicas. |
|||
|
CSIDL_COMMON_PICTURES |
O diretório do sistema de arquivos que serve como repositório para arquivos de imagem que são comuns a todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Documentos\Minhas Imagens. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\Público\Imagens. |
|||
|
CSIDL_COMMON_PROGRAMS |
O diretório do sistema de arquivos que contém os diretórios de grupos de programas comuns que aparecem no menu Iniciar de todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Menu Iniciar\Programas. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\ProgramData\Microsoft\Windows\Menu Iniciar\Programas. |
|||
|
CSIDL_COMMON_STARTMENU |
O diretório do sistema de arquivos que contém os programas e as pastas que aparecem no menu Iniciar de todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Menu Iniciar. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\ProgramData\Microsoft\Windows\Menu Iniciar. |
|||
|
CSIDL_COMMON_STARTUP |
O diretório do sistema de arquivos que contém os programas que aparecem na pasta Inicialização de todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Menu Iniciar\Programas\Inicializar. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\ProgramData\Microsoft\Windows\Menu Iniciar\Programas\Inicializar. |
|||
|
CSIDL_COMMON_TEMPLATES |
O diretório do sistema de arquivos que contém os modelos disponíveis para todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Modelos. C:\ProgramData\Microsoft\Windows\Menu Iniciar\Programas\Inicializar. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\ProgramData\Microsoft\Windows\Templates. |
|||
|
CSIDL_COMMON_VIDEO |
O diretório do sistema de arquivos que serve como repositório para arquivos de vídeo que são comuns a todos os usuários. Um caminho típico no Windows XP é C:\Documents and Settings\All Users\Documentos\Meus Vídeos. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\Público\Vídeos. |
|||
|
CSIDL_DEFAULT_APPDATA |
Faz referência à pasta Appdata em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_LOCAL_APPDATA |
Faz referência à pasta Appdata local em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_COOKIES |
Faz referência à pasta Cookies em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_CONTACTS |
Faz referência à pasta Contatos em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_DESKTOP |
Faz referência à pasta Área de Trabalho em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_DOWNLOADS |
Faz referência à pasta Downloads em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_FAVORITES |
Faz referência à pasta Favoritos em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_HISTORY |
Faz referência à pasta Histórico em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_INTERNET_CACHE |
Faz referência à pasta Cache da Internet em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_PERSONAL |
Faz referência à pasta Pessoal em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_MYDOCUMENTS |
Faz referência à pasta Meus Documentos em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_MYPICTURES |
Faz referência à pasta Minhas Imagens em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_MYMUSIC |
Faz referência à pasta Minhas Músicas em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_MYVIDEO |
Faz referência à pasta Meus Vídeos em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_RECENT |
Faz referência à pasta Recentes em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_SENDTO |
Faz referência à pasta Enviar para em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_STARTMENU |
Faz referência à pasta Menu Iniciar em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_PROGRAMS |
Faz referência à pasta Programas em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_STARTUP |
Faz referência à pasta Inicializar em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_TEMPLATES |
Faz referência à pasta Modelos em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_DEFAULT_QUICKLAUNCH |
Faz referência à pasta Início Rápido em %DEFAULTUSERPROFILE%. |
|||
|
CSIDL_FONTS |
Uma pasta virtual que contém fontes. Um caminho típico é C:\Windows\Fonts. |
|||
|
CSIDL_PROGRAM_FILESX86 |
A pasta Arquivos de Programas em sistemas de 64 bits. Um caminho típico é C:\Arquivos de Programas(86). |
|||
|
CSIDL_PROGRAM_FILES_COMMONX86 |
Uma pasta para componentes que são compartilhados entre aplicativos em sistemas de 64 bits. Um caminho típico é C:\Arquivos de Programas(86)\Common. |
|||
|
CSIDL_PROGRAM_FILES |
A pasta Arquivos de Programas. Um caminho típico é C:\Arquivos de Programas. |
|||
|
CSIDL_PROGRAM_FILES_COMMON |
Uma pasta para componentes que são compartilhados entre aplicativos. Um caminho típico é C:\Arquivos de Programas\Common. |
|||
|
CSIDL_RESOURCES |
Para computadores que executam sistemas Windows Vista®, Windows 7 ou Windows 8, o diretório do sistema de arquivos que contém dados de recursos. Um caminho típico é C:\Windows\Resources. |
|||
|
CSIDL_SYSTEM |
A pasta de Sistema do Windows. Um caminho típico é C:\Windows\System32. |
|||
|
CSIDL_WINDOWS |
O diretório do Windows ou a raiz do sistema. Corresponde às variáveis de ambiente %WINDIR% ou %SYSTEMROOT%. Um caminho típico é C:\Windows. |
|||
|
DEFAULTUSERPROFILE |
Faz referência ao valor em HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList [DefaultUserProfile]. |
|||
|
PROFILESFOLDER |
Faz referência ao valor em HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList [ProfilesDirectory]. |
|||
|
PROGRAMFILES |
Igual a CSIDL_PROGRAM_FILES. |
|||
|
PROGRAMFILES(X86) |
Faz referência à pasta C:\Arquivos de Programas (x86) em sistemas de 64 bits. |
|||
|
SYSTEM |
Faz referência a %WINDIR%\system32. |
|||
|
SYSTEM16 |
Faz referência a %WINDIR%\system. |
|||
|
SYSTEM32 |
Faz referência a %WINDIR%\system32. |
|||
|
SYSTEMPROFILE |
Faz referência ao valor em HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList\S-1-5-18 [ProfileImagePath]. |
|||
|
SYSTEMROOT |
Faz referência à raiz da unidade do sistema. |
|||
|
WINDIR |
Faz referência à pasta do Windows localizada na unidade do sistema. |
|||
Variáveis que só são reconhecidas no contexto do usuário
Você pode usar estas variáveis nas seções dos arquivos .xml com context=User e context=UserAndSystem.
| Variável | Explicação | |
|---|---|---|
|
APPDATA |
Igual a CSIDL_APPDATA. |
|
|
CSIDL_ADMINTOOLS |
O diretório do sistema de arquivos que é usado para armazenar ferramentas administrativas para um usuário individual. O MMC (Console de Gerenciamento Microsoft®) salva consoles personalizados nesse diretório, que se movimenta com o perfil do usuário. |
|
|
CSIDL_ALTSTARTUP |
O diretório do sistema de arquivos que corresponde ao grupo de programas de Inicialização não localizado do usuário. |
|
|
CSIDL_APPDATA |
O diretório do sistema de arquivos que serve como repositório comum para dados específicos de aplicativos. Um caminho típico é C:\Documents and Settings\nome do usuário\Application Data ou C:\Usuários\nome do usuário\AppData\Roaming. |
|
|
CSIDL_BITBUCKET |
A pasta virtual que contém os objetos na Lixeira do usuário. |
|
|
CSIDL_CDBURN_AREA |
O diretório do sistema de arquivos que atua como área de preparo de arquivos à espera para gravação em um CD. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Local Settings\Application Data\Microsoft\CD Burning. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Local\Microsoft\Windows\MasteredBurning\Disc Burning. |
|
|
CSIDL_CONNECTIONS |
A pasta virtual que representa as Conexões de Rede e inclui conexões discadas e de rede. |
|
|
CSIDL_CONTACTS |
Em computadores que executam sistemas Windows Vista, Windows 7 ou Windows 8, faz referência à pasta Contatos em CSIDL_PROFILE%. |
|
|
CSIDL_CONTROLS |
A pasta virtual que contém ícones para os itens do Painel de Controle. |
|
|
CSIDL_COOKIES |
O diretório do sistema de arquivos que serve como repositório comum para cookies da Internet. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Cookies. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Cookies. |
|
|
CSIDL_DESKTOP |
A pasta virtual que representa a área de trabalho do Windows. |
|
|
CSIDL_DESKTOPDIRECTORY |
O diretório do sistema de arquivos usado para armazenar fisicamente objetos de arquivo na área de trabalho e que não deve ser confundido com a pasta da área de trabalho propriamente dita. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Desktop. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\Desktop. |
|
|
CSIDL_DRIVES |
A pasta virtual que representa Meu Computador e inclui todo o conteúdo do computador local: dispositivos de armazenamento, impressoras e o Painel de Controle. Essa pasta também pode conter unidades de rede mapeadas. |
|
|
CSIDL_FAVORITES |
O diretório do sistema de arquivos que serve como repositório comum para os favoritos do usuário. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Favoritos. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\Favoritos. |
|
|
CSIDL_HISTORY |
O diretório do sistema de arquivos que serve como repositório comum para itens de histórico da Internet. |
|
|
CSIDL_INTERNET |
Uma pasta virtual para o Internet Explorer. |
|
|
CSIDL_INTERNET_CACHE |
O diretório do sistema de arquivos que serve como repositório comum para arquivos temporários da Internet. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Local Settings\Temporary Internet Files. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Local\Microsoft\Windows\Arquivos de Internet Temporários |
|
|
CSIDL_LOCAL_APPDATA |
O diretório do sistema de arquivos que serve como repositório de dados para aplicativos locais que não possuem perfil móvel. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Local Settings\Application Data. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Local. |
|
|
CSIDL_MYDOCUMENTS |
A pasta virtual que representa Meus Documentos. Um caminho típico no Windows XP é C:\Documents and Settings\Usuário\Meus Documentos. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\Documentos. |
|
|
CSIDL_MYMUSIC |
O diretório do sistema de arquivos que serve como repositório comum para arquivos de música. Um caminho típico no Windows XP é C:\Documents and Settings\Usuário\Meus Documentos\Minhas Músicas. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\Músicas. |
|
|
CSIDL_MYPICTURES |
O diretório do sistema de arquivos que serve como repositório comum para arquivos de imagem. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Meus Documentos\Minhas Imagens. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\Imagens. |
|
|
CSIDL_MYVIDEO |
O diretório do sistema de arquivos que serve como repositório comum para arquivos de vídeo. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Meus Documentos\Meus Vídeos. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\Vídeos. |
|
|
CSIDL_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 da rede. Um caminho típico é C:\Documents and Settings\nome do usuário\NetHood. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Atalhos de Rede. |
|
|
CSIDL_NETWORK |
Uma pasta virtual que representa Meus Locais de Rede, a raiz da hierarquia de namespaces de rede. |
|
|
CSIDL_PERSONAL |
Em sistemas Windows Vista, Windows 7 ou Windows 8, a pasta virtual que representa o item da área de trabalho Meus Documentos. Equivalente a CSIDL_MYDOCUMENTS. No Windows XP, o diretório do sistema de arquivos usado para armazenar fisicamente o repositório de documentos comum de um usuário. Um caminho típico é C:\Documents and Settings\nome do usuário\Meus Documentos. |
|
|
CSIDL_PLAYLISTS |
Para computadores que executam sistemas Windows Vista, Windows 7 ou Windows 8, a pasta virtual usada para armazenar álbuns de reprodução, geralmente C:\Usuários\nome do usuário\Minhas Músicas\Listas de Reprodução. |
|
|
CSIDL_PRINTERS |
A pasta virtual que contém impressoras instaladas. |
|
|
CSIDL_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 no Windows XP é C:\Documents and Settings\nome do usuário\PrintHood. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Atalhos de Impressoras. |
|
|
CSIDL_PROFILE |
A pasta de perfil do usuário. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário. |
|
|
CSIDL_PROGRAMS |
O diretório do sistema de arquivos que contém os grupos de programas do usuário, que são por si só diretórios do sistema de arquivos. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Menu Iniciar\Programas. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Menu Iniciar\Programas. |
|
|
CSIDL_RECENT |
O diretório do sistema de arquivos que contém atalhos para os documentos que o usuário utilizou mais recentemente. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Meus Documentos Recentes. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Recentes. |
|
|
CSIDL_SENDTO |
O diretório do sistema de arquivos que contém itens do menu Enviar para. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\SendTo. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\SendTo. |
|
|
CSIDL_STARTMENU |
O diretório do sistema de arquivos que contém itens do menu Iniciar. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Menu Iniciar. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Menu Iniciar. |
|
|
CSIDL_STARTUP |
O diretório do sistema de arquivos que corresponde ao grupo de programas de Inicialização do usuário. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Menu Iniciar\Programas\Inicializar. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Menu Iniciar\Programas\Inicializar. |
|
|
CSIDL_TEMPLATES |
O diretório do sistema de arquivos que serve como repositório comum para modelos de documento. Um caminho típico no Windows XP é C:\Documents and Settings\nome do usuário\Templates. Um caminho típico nos sistemas Windows Vista, Windows 7 ou Windows 8 é C:\Usuários\nome do usuário\AppData\Roaming\Microsoft\Windows\Modelos. |
|
|
HOMEPATH |
O mesmo que a variável de ambiente padrão. |
|
|
TEMP |
A pasta temporária no computador. Para o Windows XP, um caminho típico é %USERPROFILE%\Local Settings\Temp. Para sistemas Windows Vista, Windows 7 ou Windows 8, um caminho típico é %USERPROFILE%\AppData\Local\Temp. |
|
|
TMP |
A pasta temporária no computador. Para o Windows XP, um caminho típico é %USERPROFILE%\Local Settings\Temp. Para sistemas Windows Vista, Windows 7 ou Windows 8, um caminho típico é %USERPROFILE%\AppData\Local\Temp. |
|
|
USERPROFILE |
Igual a CSIDL_PROFILE. |
|
|
USERSID |
Representa o SID (Identificador de segurança) da conta do usuário atual. Por exemplo, S-1-5-21-1714567821-1326601894-715345443-1026. |
|