[MF] MARCELO FRANCO
[ DOC #05 // LEGADO & PDV ] 2026-10-18

> 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.

AUTOR......: Marcelo Franco
ARQUIVO....: posts/05-VFPA-vs-VFP9-Blindando-File-Locks.md
LEITURA....: 12 min // NÍVEL: Avançado

[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).
[ FIGURA // img/artigo05-img1.webp ]
Diagrama mostrando como o cache local do SMB3 na Estação A atrasa a gravação e faz a Estação B ler um ponteiro de índice CDX defasado no VFP9
LEGENDA: Diagrama mostrando como o cache local do SMB3 na Estação A atrasa a gravação e faz a Estação B ler um ponteiro de índice CDX defasado no VFP9

[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.
> Q. Eu preciso alterar meus comandos RLOCK(), FLOCK() ou REPLACE nos arquivos .PRG para aproveitar essas melhorias?
A. Não precisa mexer em nada no código de negócio. Toda a mágica acontece dentro das novas DLLs de runtime. A única coisa que você precisa adicionar no início do seu PRG principal, caso queira permitir que as tabelas passem de 2GB, é a linha SYS(9071, 1) para ligar o modo de arquivos grandes.

[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.
> Q. Qual é o jeito mais limpo de resolver o problema da pasta C:\meuerp para usuários sem senha de Administrador?
A. O ideal é atacar em duas frentes simples: primeiro, garanta que no seu config.fpw (ou no início do código) os arquivos temporários apontem para a pasta oficial do usuário no Windows usando TMPFILES = GETENV("TEMP"), tirando o peso de dentro do C:\meuerp. Segundo, coloque o seu instalador para rodar um comando simples do Windows que libera a escrita na pasta do sistema para usuários comuns: icacls "C:\meuerp" /grant Usuarios:(OI)(CI)M.

[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 DiaComo o VFP 9.0 SP2 ReageComo o VFPA (32/64-bit) ReageO 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 GBTravamento 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:\meuerpSe 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 BloqueadaCongela 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óriosBate 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.
// NOTA DO ESPECIALISTA & DIAGNÓSTICO

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.

// OUTRAS PUBLICAÇÕES DO CADERNO TÉCNICO [ VER CATÁLOGO COMPLETO -> ]
DOC #13 // AUTOMAçãO & HW 2026-11-03
> O Hardware Oculto na sua Gaveta: Como Firmwares Alternativas Transformam Gadgets Comuns em Supermáquinas
De roteadores esquecidos a rádios de R$ 100, tomadas inteligentes e impressoras 3D, o plástico dos aparelhos domésticos esconde processadores potentes travados por softwares de fábrica medíocres. Uma viagem pelo universo das firmwares alternativas — como OpenWrt, Klipper, Tasmota e Egzumer —, as vantagens reais sobre o código original e como destravar o potencial adormecido do seu silício.
DOC #12 // BAIXO NíVEL 2026-11-03
> Por que o nome do seu Wi-Fi pode revelar onde você mora: A física dos Beacon Frames, OSINT e o mapa invisível do WiGLE
Batizar a rede doméstica com o sobrenome da família ou o número do apartamento parece inofensivo até você entender como o protocolo 802.11 grita para a rua dez vezes por segundo. Como bases globais de wardriving, triangulação por BSSID e os sistemas de localização da Apple e do Google transformam o seu roteador em uma âncora geográfica pública — e como blindar sua rede.
DOC #11 // BAIXO NíVEL 2026-10-25
> Por que o ERP trava no PC do funcionário (e a ilusão dos processadores de muitos núcleos)
Comprei um computador de 8 núcleos para o faturamento e o ERP continua travando na tela de emissão. Como o laço de eventos do Windows, o IPC e as linguagens de desktop (Delphi, FoxPro, C# WinForms e VB6) explicam por que o aplicativo do operador depende de um único núcleo veloz — e por que PCs corporativos baratos com muitos núcleos fracos transformam o expediente em lentidão crônica.
DOC #10 // BAIXO NíVEL 2026-10-23
> Engenharia Reversa na Elgin L42 Pro (Parte 2): Transformando a USB em Rede Virtual, Web-Over-USB e o Fim do PrintNightmare
Por que tratar um computador Linux de 32 bits como uma impressora USB burra dos anos 90? Como aposentamos o driver g_printer.ko, subimos um Composite Gadget USB (IEEE 1284 + Ethernet Virtual) e demos IP próprio para a impressora pelo cabo USB — sepultando de vez os erros 0x0000011b e o pesadelo do spooler Windows.
DOC #09 // BAIXO NíVEL 2026-10-23
> Engenharia Reversa na Elgin L42 Pro: O que o Firmware Esconde sobre Gaps, Microssegundos e o Fantasma do Cabo USB
Uma impressora térmica não é só borracha e engrenagem: quando ela pula etiquetas ou para do nada, a culpa quase nunca é da mecânica. Dissecamos o firmware oficial e encontramos Linux, FreeRTOS, projeção matemática de passos e um mistério elétrico de míseros 51,5 mV.
DOC #08 // BAIXO NíVEL 2026-10-21
> A importância da documentação técnica pelo analista: mitigação de risco e isenção de responsabilidade
Em TI e suporte de sistemas, o que não está formalmente registrado simplesmente não existe. Como o registro técnico diligente de incidentes, causas-raízes e alertas de risco blinda o analista e a software house contra acusações de negligência e imperícia sob a ótica de frameworks como ITIL, ISO/IEC 20000 e COBIT.
DOC #07 // INFRA & CLOUD 2026-10-20
> O Software Não Roda no Vácuo: Limites de Suporte, Infraestrutura Hostil e o Operador Despreparado
Por que empresas de software viram reféns de redes instáveis, desligamentos de servidor na tomada e clientes que recusam reinvestir, como quebrar o ciclo vicioso do "suporte muleta" e o papel do ITIL, da matriz RACI e do onboarding na emancipação da operação.
DOC #06 // LEGADO & PDV 2026-10-19
> Preparação mínima do Windows para ambientes de Software Fiscal e PDV
Guia prático em três comandos PowerShell para blindar terminais Windows de frente de caixa: eliminação de quedas de periféricos USB (PinPad/Impressora), desativação do Fast Startup, sincronização de horário fiscal com Brasília mesmo com a porta 123 UDP bloqueada e neutralização do UAC e Secure Desktop que travam a tela do caixa.
DOC #04 // BAIXO NíVEL 2026-10-09
> Por que entender alocação de memória e protocolos de rede ainda importa na era dos frameworks
Abstrações são excelentes para velocidade inicial, mas quando a operação trava em produção às 2h da manhã com CPU em 8% e memória livre, apenas o domínio de sockets, alocação de memória e chamadas de sistema separa o diagnóstico cirúrgico do improviso.
DOC #03 // AUTOMAçãO & HW 2026-09-28
> Sincronização em tempo real entre ERPs, balanças de rede e displays de mídia indoor
Como eliminar a redigitação de preços e a divergência entre a etiqueta da balança (Toledo/Prix) e as TVs do açougue e padaria usando o próprio arquivo TXITENS.TXT como fonte única da verdade.
DOC #02 // INFRA & CLOUD 2026-09-14
> Usando dois provedores de internet: redundância, estabilidade e performance para PMEs com baixo custo
Como blindar pequenas e médias empresas contra quedas de internet unificando dois links comuns em roteadores Dual WAN acessíveis, baratos e de configuração praticamente Plug and Play.
DOC #01 // LEGADO & PDV 2026-08-29
> Por que sistemas legados de PDV falham ao integrar com APIs modernas (e como resolver)
Sistemas fiscais construídos nos anos 90 e 2000 operam de forma síncrona e blocante. Quando expostos diretamente a webhooks financeiros ou redes instáveis, travam o caixa.