> VFPA vs VFP9: Blindando File Locks em Redes SMB e Permissões NTFS
Análise profunda de como a reescrita do núcleo em C++ no Visual FoxPro Advanced erradica corrupções de DBF/CDX sob SMB2/SMB3, rompe o limite de 2GB com ponteiros de 64 bits e elimina crashes fatais C0000005 em diretórios restritos como C:\meuerp.
[01] 1. O Projeto Visual FoxPro Advanced (VFPA)
[ ^ TOPO ]Quem mantém sistemas grandes em FoxPro sabe que a linguagem parou oficialmente no tempo em 2007, com o lançamento do VFP 9.0 SP2. O problema é que o Windows evoluiu, as redes mudaram completamente e o motor original de 32 bits — desenhado pensando na arquitetura do Windows XP — começou a sofrer para rodar em infraestruturas modernas. É exatamente aí que entra o Visual FoxPro Advanced (VFPA), mantido pelo engenheiro chinês Chuanbing Chen.
Longe de ser apenas um "patch" superficial, o VFPA é uma engenharia reversa pesada que reescreve partes críticas do núcleo em C++ do FoxPro original. Ele entrega compilações modernas do runtime e da própria IDE em 32 bits e 64 bits nativos, trocando chamadas antigas da API do Windows por instruções atuais do sistema operacional.
Na prática, o projeto dá uma sobrevida real aos sistemas legados sem exigir que você reescreva milhões de linhas de código. Entre as centenas de correções de bugs de memória, três mudanças salvam a pele de quem tem ERP rodando em clientes grandes:
- Fim da barreira de 2GB por tabela: O suporte a Large Files permite que seus arquivos .DBF, .FPT e .CDX passem tranquilamente do antigo limite de 2 gigabytes. O teto agora é o próprio sistema de arquivos NTFS.
- Fôlego real de memória RAM: Na versão de 64 bits, o sistema deixa de bater naquele teto sufocante de 2GB de RAM por processo. Você pode configurar o SYS(3050) para usar fatias generosas da memória física da máquina, acelerando consultas e relatórios pesados.
- Executável autossuficiente: O compilador permite embutir as DLLs de runtime direto dentro do .EXE, acabando com a dor de cabeça de registrar bibliotecas ou lidar com versões conflitantes nas máquinas dos usuários.
[02] 2. O Protocolo SMB2/SMB3 e a Dor de Cabeça no VFP Clássico
[ ^ TOPO ]Se você já perdeu uma manhã reconstruindo índices corrompidos porque o sistema travou do nada na rede, o culpado quase certamente atende pelo nome de Server Message Block (SMB). Até a época do Windows XP e Server 2003, a rede falava SMB1. Era um protocolo lento e "tagarela", mas tinha uma vantagem para o FoxPro: tudo era síncrono. Se uma máquina gravava um byte no servidor, a rede confirmava na hora.
Do Windows Vista e Server 2008 para cá, a Microsoft entrou na era do SMB2 e SMB3. Para fazer a rede voar ao transferir arquivos grandes, o Windows passou a usar caches agressivos na própria estação de trabalho, controlados por Opportunistic Locks (OpLocks) e Leases. Em resumo: o Windows segura leituras e escritas na memória da máquina local para economizar viagens no cabo de rede.
O grande conflito é que o VFP Clássico não é um banco Cliente-Servidor como o SQL Server; ele é um sistema de arquivo compartilhado. Quando vinte usuários abrem a tabela clientes.dbf ao mesmo tempo, as próprias estações coordenam quem está mexendo em qual linha aplicando travas físicas diretamente nos bytes do arquivo remoto (Byte-Range Locks). O VFP 9 confia cegamente que o disco da rede responde em tempo real (Write-Through). Se a máquina do João grava um registro novo e atualiza o índice .CDX, a máquina da Maria precisa ver essa alteração no exato milissegundo seguinte.
Quando o SMB moderno tenta "ajudar" guardando dados em cache, a sincronia do FoxPro vai para o espaço e aparecem aqueles erros clássicos do dia a dia:
- Leitura defasada e quebra de índice: A estação A adiciona um cliente e atualiza a árvore do arquivo .CDX lá no servidor. Um instante depois, a estação B vai pesquisar nessa mesma tabela. O Windows da estação B acha que o arquivo não mudou e entrega um pedaço do índice que estava guardado no cache da memória RAM local. O VFP 9 tenta ler o arquivo usando ponteiros que não batem mais com a realidade e estoura na tela o famoso Index does not match the table (Erro 114).
- Gravação atrasada e tabela corrompida: A estação A dá um APPEND BLANK e libera o registro. O protocolo SMB segura essa gravação no buffer local por alguns milissegundos. Nesse meio tempo, a estação B trava o cabeçalho da tabela, insere outro registro e salva. Quando o Windows da estação A finalmente resolve despejar o buffer atrasado na rede, ele passa por cima do cabeçalho do DBF com dados velhos. O resultado na manhã seguinte é o temido Not a table (Erro 15).
- Falsos travamentos de rede: Como o SMB3 leva alguns milissegundos negociando a liberação de cache entre o servidor e as máquinas, o VFP 9 — que tem um tempo de espera curtíssimo — acha que o arquivo está preso e joga na cara do usuário um falso File is in use by another user (Erro 108) ou File access is denied (Erro 1705).
[03] 3. Como o VFPA Resolve os File Locks e Rompe a Barreira dos 2GB
[ ^ TOPO ]Durante anos, a única receita de bolo para fazer o VFP 9 parar de corromper dados no Windows Server moderno era sabotar a própria rede do cliente. O suporte técnico tinha que rodar scripts no Registro do Windows (.reg) no servidor e em todas as estações para zerar os tempos de cache (DirectoryCacheLifetime, FileInfoCacheLifetime) e desligar os OpLocks. Funcionava para o FoxPro, mas deixava o resto da rede da empresa se arrastando.
O VFPA resolve essa briga no lugar certo: dentro do próprio motor em C++. Em vez de exigir que você desligue as otimizações do Windows Server, o VFPA muda a forma como o runtime conversa com as APIs de disco do Windows (CreateFile, WriteFile e LockFileEx).
// Como funciona a gravação na rede: VFP Clássico vs VFPA [VFP9 Clássico] ──► WriteFile() ──► [Fica preso no Cache SMB] ──(Atraso)──► Colisão no Servidor (Quebra o CDX) [VFPA Runtime ] ──► WriteFile() + FlushFileBuffers() + Retries ──► [Fura o Cache] ──► Gravação Limpa no Disco
Essa blindagem do VFPA trabalha em três frentes sem que você precise mudar uma vírgula no seu código:
- Limpeza forçada de buffer (Flush cirúrgico): Toda vez que o seu sistema executa uma operação sensível — como RLOCK(), FLOCK(), UNLOCK ou fecha um END TRANSACTION —, o próprio VFPA dá um comando direto para o Windows descarregar os buffers de rede daquela tabela específica na mesma hora. O servidor continua rápido para o resto da empresa, mas os seus arquivos .DBF, .CDX e .FPT são gravados no disco sem hesitação.
- Paciência automática na rede (Silent Retries): No VFP 9 antigo, se o Windows demorasse uma fração de segundo para liberar o cache de outra máquina, o erro já estourava na tela. O VFPA coloca um loop silencioso de novas tentativas direto na camada em C++. Se a tabela estiver no meio de uma transição de Lease do SMB, o motor espera alguns milissegundos e tenta de novo por baixo dos panos antes de devolver qualquer erro para o seu .PRG.
- Travas de registro em 64 bits: No FoxPro clássico, o cálculo para travar um registro na rede usava números inteiros de 32 bits, que só vão até 2.147.483.647 bytes (exatos 2GB). O VFP controla quem travou o quê marcando um byte "virtual" perto do limite de 2GB menos o número do registro. Se a tabela passasse de 2GB físicos, os dados reais dos clientes invadiam essa área de controle de travamento, destruindo o arquivo. O VFPA troca essa conta para endereçamento de 64 bits na API do Windows, jogando a área de controle de locks lá para a casa dos Exabytes. É isso que permite ter dezenas de usuários dando RLOCK() simultaneamente em uma tabela de 5GB ou 10GB com segurança total.
[04] 4. O Caso `C:\meuerp` e a Dor de Cabeça do Usuário sem Permissão de Admin
[ ^ TOPO ]Outro cenário clássico que tira o sono de quem dá suporte em sistemas VFP acontece na própria estação de trabalho. Imagine aquele padrão muito comum no Brasil: o sistema é instalado direto na raiz do disco, numa pasta como C:\meuerp, misturando o executável, relatórios e subpastas de trabalho (C:\meuerp\dados ou C:\meuerp\temp). Tudo funciona perfeitamente nos testes até o dia em que o TI do cliente resolve aplicar regras de segurança no domínio e tira a permissão de Administrador Local dos funcionários.
Nos Windows modernos (Windows 10 e 11), qualquer pasta criada direto na raiz C:\ tem uma regra rígida no NTFS: apenas Administradores e o próprio Sistema têm controle total. Um usuário comum (Conta Padrão) só ganha permissão automática para alterar arquivos que ele mesmo criou ali dentro. Se foi o técnico de TI quem copiou a pasta C:\meuerp usando a senha de administrador, o funcionário do caixa ou do faturamento entra no Windows tendo apenas permissão de Leitura sobre aqueles arquivos.
Veja o que acontece nos bastidores quando esse usuário comum abre o sistema em C:\meuerp e tenta trabalhar:
// Quando um usuário sem Admin tenta gravar algo dentro de C:\meuerp [VFP9 Clássico] ──► Separa Memória ──► Windows Bloqueia (NTFS) ──► Ponteiro se Perde ──► CRASH C0000005 (Fecha na cara) [VFPA Runtime ] ──► Checa Permissão ──► Windows Bloqueia (NTFS) ──► Limpa a Memória ──► Gera Erro 111/1705 (Cai no ON ERROR)
// A) O Capotamento no VFP Clássico (Fatal Error C0000005)
O VFP 9 foi feito numa época em que quase todo mundo usava o Windows como Administrador. Quando o usuário comum tenta rodar uma rotina que grava um log local, recria um índice em C:\meuerp ou quando o próprio FoxPro tenta criar um arquivo temporário (.TMP) para montar um relatório ou fazer um SELECT ... INTO CURSOR pesado porque os temporários estão apontando para C:\meuerp\temp (ou nem foram configurados no config.fpw):
- O motor do VFP 9 nem cogita que pode ser barrado. Ele já separa o espaço na memória RAM e prepara os ponteiros internos em C++ contando como certo que o arquivo vai ser aberto para escrita.
- Na hora de gravar no disco, o NTFS do Windows bate a porta na cara do VFP por falta de permissão na pasta C:\meuerp.
- O grande bug do VFP 9 está no que acontece um milissegundo depois: em várias rotinas internas (especialmente na abertura de cursores e relatórios), o código antigo em C++ não checa direito se o Windows devolveu um erro de permissão antes de tentar usar o ponteiro de memória.
- Sem ter para onde ir, o motor tenta gravar num endereço de memória inválido e o Windows derruba o processo na hora por questão de segurança. É o famoso Fatal Error: Exception code=C0000005. O sistema simplesmente some da tela na frente do cliente, sem salvar nada, sem passar pelo seu TRY...CATCH e sem acionar a sua rotina de ON ERROR. Você perde horas procurando erro de lógica no seu código quando, na verdade, foi apenas um bloqueio de pasta do Windows.
// B) Como o VFPA Lida com a Situação sem Fechar o Sistema
O VFPA traz um manifesto de segurança atualizado para os padrões do UAC (User Account Control) e corrige toda essa checagem de ponteiros no código em C++. Na mesmíssima situação, com o usuário sem privilégio de administrador tentando gravar na pasta bloqueada C:\meuerp:
- Checagem antes do pulo: Antes de comprometer a memória interna do cursor ou do índice, o VFPA confere se o Windows realmente liberou o acesso de escrita (handle válido).
- Fim do fechamento abrupto: Quando o NTFS nega a gravação em C:\meuerp, o VFPA não entra em pânico. Ele recolhe a memória que tinha separado, cancela a operação de disco com segurança e transforma o bloqueio do Windows em um erro normal do FoxPro.
- Erro claro na mão do programador: Em vez de o programa fechar sozinho com um C0000005 misterioso no meio de um relatório, o VFPA mantém a tela aberta e joga o problema direto para o seu tratamento de erros (ON ERROR), disparando o Erro 111 (Cannot update the cursor, since it is read-only) ou o Erro 1705 (File access is denied). Você descobre na hora qual linha tentou gravar onde não podia e já sabe que é falta de permissão na pasta.
[05] 5. Resumo na Prática: VFP 9.0 SP2 vs VFPA
[ ^ TOPO ]Para facilitar a visualização do que muda no dia a dia do suporte e do desenvolvimento, veja como cada versão reage aos problemas clássicos de infraestrutura:
| Situação do Dia a Dia | Como o VFP 9.0 SP2 Reage | Como o VFPA (32/64-bit) Reage | O que fazer na prática |
|---|---|---|---|
| Rede Windows Server (SMB2/SMB3) | Bate de frente com o cache do Windows; corrompe índices .CDX e dá falsos erros de arquivo em uso. | Força a descarga do buffer (Flush) direto na API do Windows e faz novas tentativas silenciosas. | Atualizar o runtime para o VFPA e deixar o cache nativo do servidor trabalhar em paz. |
| Tabelas chegando perto dos 2 GB | Travamento total ou destruição dos dados quando a tabela passa de 2 GB físicos na rede. | Calcula os locks de registro em 64 bits, permitindo tabelas gigantescas sem colisão. | Colocar SYS(9071, 1) no início do sistema para liberar tabelas acima de 2 GB. |
| Usuário sem Admin em C:\meuerp | Se perde nos ponteiros de memória ao ser barrado pelo Windows e fecha sozinho com Erro C0000005. | Segura a falha de permissão com limpeza e devolve Erro 111 ou 1705 para o seu sistema tratar. | Tratar o erro de permissão no ON ERROR e liberar a pasta com icacls durante a instalação. |
| Pasta de Temporários Bloqueada | Congela a tela ou fecha o sistema do nada quando o usuário tenta abrir um relatório ou consulta grande. | Avisa imediatamente na linha exata do código que não conseguiu criar o arquivo .TMP no disco. | Apontar o TMPFILES sempre para a pasta %LOCALAPPDATA%\Temp exclusiva de cada usuário logado. |
| Consumo de Memória em Relatórios | Bate rápido no limite de 2 GB da arquitetura antiga e estoura There is not enough memory. | Na versão de 64 bits, enxerga toda a memória RAM da máquina para processar cursores pesados. | Ajustar o SYS(3050) para aproveitar a memória real disponível nas máquinas modernas ou no TS. |
Migrar o runtime para o VFPA elimina a necessidade de mutilar o registro do Windows Server desativando OpLocks globais, mas exige que a engenharia higienize a arquitetura local, isolando arquivos temporários (%TEMP%) para fora da raiz do disco e ajustando as ACLs de rede.
