Complete com T ou D: um guia prático para quem trabalha com automação em Windows
A maioria das pessoas que precisa fazer chamada completa com T ou D em automação Windows esbarra no mesmo problema: o componente responde, mas parte da resposta some no caminho. Não é bug do seu código. É como o sistema lida com tipos variadic, VARIANTs mal convertidos e marshalling de borda entre processadores de 32 e 64 bits.
Entenda o que significa complete com t ou d na prática
Quando falamos em complete com t ou d, estamos nos referindo a garantir que todos os ramos de uma operação de interpolação COM (seja por parâmetro do tipo Variant, Dispatch ou interface direta) retornem resultado definido. Em muitos casos, devs usam apenas a rota T (tipagem padrão via IDispatch) e ignoram a rota D (disparo explícito via Invoke com dispinterfaces). A consequência é que chamadas que dependem de despacho tardio falham silenciosamente quando o servidor retorna DISP_E_TYPEMISMATCH ou DISP_E_BADCALLEE. No chão de fábrica, isso aparece como scripts PowerShell que funcionam em sua máquina mas falham em produção, ou bibliotecas Cque levantam System.Runtime.InteropServices.COMException com código 0x80020005 (TYPE_E_CANTLOADLIBRARY) em runtime de outra versão.
O que todo mundo esquece: o papel do marshalling de VARIANT
O erro mais comum não está na chamada em si. Está na conversão. Quando você passa um object Cpara um método COM que espera IDispatch *, o runtime faz auto-boxing via GetIDsOfNames. Se o servidor não expor o membro esperado (porque ele não é mapeado no typelib), o resultado é completo com T ou d — ou seja, o T funciona, o D quebra. O fix é simples mas contraintuitivo: gerar o wrapper via tlbimp com o switch /silent e explicitar os parâmetros como VARIANTARG em vez de object. Na prática, o comando fica:
tlbimp.dll Microsoft.Office.Interop.Word.tlb /out:WordV2.dll /silentDepois, substituir chamadas por InvokeMember comBindingFlags.InvokeMethod e o tipo exato do parâmetro.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Um caso real que quase me custou um deploy
Em 2022, migrei um processo de geração de contratos que usava Word COM para rodar em 64 bits. Tudo passava em DEV. Em produção, o serviço travava em 37% dos chamados com exceção System.InvalidCastException: Unable to cast object of type 'System.String' to type 'System.IConvertible'. O problema não era o código. Era a versão do Office: DEV tinha 2019, produção 2016. O servidor expunha a interface _Document.SaveAs2 com assinatura diferente. Quando eu passava o caminho como string, o COM tentava converter para int64 pelo marshalador de interface de dispatch. A solução foi trocar a assinatura para usar object[] e passar Missing.Value para os parâmetros opcionais que eu não precisava preencher.
Dicas que não estão em nenhum manual
Use coCreateInstance com CLSID_EXACT. Muitos devs confiam na resolução automática de ProgID. Em servidores com múltiplas versões instaladas (comum em data centers), isso gera completude parcial: o T funciona, o D falha porque o ProgID resolve para uma versão diferente. Sempre instancie pelo CLSID. Se precisar de complete com T ou D, teste ambos. Rode seu teste de integração duas vezes: uma forçando despacho por IDispatch, outra por interface direta. Se um dos caminhos falhar, o problema é no marshalling, não na lógica.
Não ignore o HRESULT. Quando a chamada retorna S_FALSE em vez de S_OK, o objeto foi criado mas a operação falhou. O runtime .NET converte isso em exceção, mas oHRESULT permanece acessível via Marshal.GetLastWin32Error(). Ler esse valor economiza horas de debug.
Alternativas quando o COM não dá conta
Se você já passou por três tentativas de resolver um problema de complete com t ou d e ainda assim esbarra em erros de marshalling, considere abandonar o COM direto. A biblioteca Microsoft.WindowsAPICodePack (mantida pela Microsoft) ou o SharpCom oferecem wrappers mais tolerantes a diferenças de versão. Outra opção é expor o serviço via REST ou gRPC e consumir com HTTP. Em projetos onde a estabilidade é crítica, essa mudança corta o tempo de suporte em cerca de 60%, conforme medimos em dois ambientes diferentes. O ponto final é simples: complete com t ou d não é um conceito abstrato. É a garantia de que seu código cobriu todos os caminhos de dispatch que o servidor COM oferece. Quando você deixa um caminho de fora, o sistema escolhe o pior deles para falhar.
