OneDrive Known Folder Move Quebra Caminhos de Arquivos de Aplicativos Legados

Ao redirecionar as pastas Área de Trabalho, Documentos ou Imagens para o OneDrive usando o Known Folder Move, alguns aplicativos mais antigos param de funcionar corretamente. Esses aplicativos legados geralmente usam caminhos de arquivo locais fixos que não existem mais após a movimentação. Este artigo explica por que o Known Folder Move causa essas quebras de caminho, como identificar os aplicativos afetados e as etapas exatas para ajustar os caminhos de arquivo ou configurar o Known Folder Move para evitar o problema.

Por que o Known Folder Move Altera os Caminhos de Arquivo

O Known Folder Move é um recurso do OneDrive que redireciona as pastas Área de Trabalho, Documentos e Imagens do perfil de usuário local para uma pasta do OneDrive. Após a movimentação, o local original da pasta em C:\Usuários\[NomeDeUsuário]\Desktop se torna um ponto de junção que aponta para C:\Usuários\[NomeDeUsuário]\OneDrive\Desktop. Muitos aplicativos legados escritos antes do Windows 8 armazenam caminhos de arquivo como caminhos absolutos em arquivos de configuração, bancos de dados ou entradas do registro. Quando a pasta é movida, esses caminhos fixos não resolvem mais para o local real do arquivo.

O ponto de junção criado pelo Windows é transparente para a maioria dos aplicativos modernos que usam a API Shell. No entanto, aplicativos legados que chamam o caminho antigo diretamente por meio de APIs do sistema de arquivos, como CreateFile ou FindFirstFile, sem seguir os pontos de reanálise, falharão. Essas falhas incluem erros como “Arquivo não encontrado”, “Caminho não existe” ou o aplicativo travando na inicialização. O problema é mais comum em aplicativos de linha de negócios, scripts personalizados e ferramentas de produtividade mais antigas que não foram atualizadas para o redirecionamento de pastas na nuvem.

Quais Pastas São Afetadas

O Known Folder Move afeta apenas as três pastas que você redireciona explicitamente: Área de Trabalho, Documentos e Imagens. Outras pastas de usuário, como Downloads, Música, Vídeos e Favoritos, permanecem no perfil local. Aplicativos legados que referenciam qualquer uma das três pastas redirecionadas com um caminho absoluto fixo quebrarão. Aplicativos que usam variáveis de ambiente como %USERPROFILE% ou a API SHGetKnownFolderPath geralmente continuam funcionando porque resolvem para o local redirecionado.

Etapas para Corrigir Caminhos de Arquivo de Aplicativos Legados Após o Known Folder Move

A correção principal é atualizar os caminhos fixos no aplicativo legado para apontar para o novo local da pasta do OneDrive. As etapas abaixo cobrem os métodos mais comuns para encontrar e corrigir esses caminhos.

1. Identifique o aplicativo legado que está falhando
   Abra o aplicativo e reproduza o erro. Anote a mensagem de erro exata. Mensagens comuns incluem “Não é possível encontrar o arquivo” ou “Caminho não encontrado.” Verifique a documentação do aplicativo ou o site de suporte para problemas conhecidos com redirecionamento de pastas.
2. Localize a referência de caminho fixo
   Pesquise nos arquivos de configuração do aplicativo por caminhos absolutos. Locais comuns incluem:
   • Arquivos .ini ou .cfg do aplicativo na pasta de instalação em C:\Program Files ou C:\Program Files (x86)
   • Chaves do registro em HKEY_CURRENT_USER\Software\[Fornecedor]\[App] ou HKEY_LOCAL_MACHINE\Software\[Fornecedor]\[App]
   • Strings de conexão de banco de dados ou caminhos de servidor de arquivos armazenados em um banco de dados local

   Use o Bloco de Notas para abrir arquivos .ini ou .cfg. Use o Regedit para navegar pelas chaves do registro. Faça um backup de qualquer arquivo ou chave antes de editar.

3. Substitua o caminho antigo pelo novo caminho do OneDrive
   Altere o caminho de C:\Usuários\[NomeDeUsuário]\Desktop para C:\Usuários\[NomeDeUsuário]\OneDrive\Desktop. Repita para Documentos e Imagens, se necessário. Use a variável de ambiente %USERPROFILE% se o aplicativo suportar expansão de variável de ambiente. Por exemplo: %USERPROFILE%\OneDrive\Documents.
4. Teste o aplicativo
   Reinicie o aplicativo e verifique se o erro não aparece mais. Tente abrir, salvar e criar arquivos na pasta afetada para confirmar a funcionalidade completa.
5. Se o aplicativo ainda falhar, reverta o Known Folder Move para essa pasta
   Abra as configurações do OneDrive. Vá para Sincronizar e fazer backup > Gerenciar backup. Clique em Parar backup ao lado da pasta que está causando o problema. Isso move a pasta de volta para o local local original. Observe que os arquivos já no OneDrive serão copiados de volta para o perfil local, o que pode levar tempo dependendo do número de arquivos.

Se o Known Folder Move do OneDrive Ainda Causar Erros no Aplicativo

O aplicativo usa um compartilhamento de rede ou unidade mapeada

Alguns aplicativos legados armazenam caminhos de arquivo como caminhos UNC ou letras de unidade mapeada. Após o Known Folder Move, a pasta local não está mais na letra de unidade esperada. Verifique as configurações do aplicativo para um caminho base configurável. Se o aplicativo permitir, altere o caminho base para %USERPROFILE%\OneDrive\Desktop. Se o aplicativo não suportar variáveis de ambiente, use o caminho absoluto completo.

O aplicativo trava na inicialização com um erro de DLL ausente

Certos aplicativos legados armazenam seu diretório de trabalho na pasta Área de Trabalho ou Documentos. Quando essa pasta é movida, o aplicativo não consegue encontrar seus próprios arquivos de suporte. Reinstale o aplicativo em uma pasta fora das pastas redirecionadas, como C:\Program Files\[NomeDoApp]. Alternativamente, configure o aplicativo para usar uma pasta local como C:\AppData\[NomeDoApp] para seu diretório de trabalho.

A Política de Grupo impõe o Known Folder Move e você não pode revertê-lo

Em ambientes gerenciados, os administradores de TI podem impor o Known Folder Move por meio da Política de Grupo. Se você não puder parar o backup de uma pasta, entre em contato com o departamento de TI. Eles podem criar uma exceção de política para grupos de usuários ou máquinas específicos que executam aplicativos legados. Como solução alternativa, você pode criar um link simbólico ou junção do caminho da pasta original para o novo caminho do OneDrive usando o comando mklink /J C:\Usuários\[NomeDeUsuário]\Desktop C:\Usuários\[NomeDeUsuário]\OneDrive\Desktop. No entanto, isso pode causar conflitos de sincronização e não é recomendado como solução de longo prazo.

Known Folder Move vs Manter Pastas Locais: Principais Diferenças

Item	Known Folder Move (OneDrive)	Manter Pastas Locais
Local do arquivo	Área de Trabalho, Documentos, Imagens movidos para a pasta do OneDrive	Pastas permanecem em C:\Usuários\[NomeDeUsuário]
Compatibilidade com aplicativos legados	Pode quebrar aplicativos com caminhos absolutos fixos	Sem alterações de caminho; aplicativos funcionam como antes
Backup na nuvem	Sincronização automática com o OneDrive	Sem backup automático na nuvem, a menos que configurado separadamente
Método de configuração	Configurações do OneDrive > Sincronizar e fazer backup > Gerenciar backup	Não ative o Known Folder Move; use backup manual de pastas
Processo de reversão	Parar backup nas configurações do OneDrive; arquivos são copiados de volta	Não aplicável

Agora você pode diagnosticar e corrigir problemas de caminho de arquivo em aplicativos legados causados pelo Known Folder Move. Comece verificando os arquivos de configuração do aplicativo em busca de caminhos absolutos fixos. Se o aplicativo não puder ser atualizado, reverta o backup da pasta específica nas configurações do OneDrive. Para ambientes gerenciados, use a Política de Grupo para excluir usuários de aplicativos legados do Known Folder Move. Uma dica avançada: use o Process Monitor da Microsoft Sysinternals para rastrear qual caminho de arquivo o aplicativo com falha está tentando acessar e, em seguida, atualize esse caminho exato.