Compartilhar via

Capturando logs WinHTTP

  • Artigo

Importante

Este procedimento está disponível apenas para versões do sistema operacional anteriores ao Windows 7 ou ao Windows Server 2008 R2.

Os logs do WinHTTP podem ser usados para ajudar a solucionar problemas de aplicativos WSDAPI. Isso é útil quando a troca de metadados falha ou quando a negociação SSL/TLS falha.

Este procedimento mostra como capturar logs WinHTTP no computador cliente. O aplicativo cliente baseado em WSDAPI não deve estar em execução quando o registro em log está habilitado. Se o aplicativo cliente estiver em execução quando o registro em log estiver habilitado, o cliente e/ou o computador deverão ser reiniciados antes que WS-Discovery e o tráfego de troca de metadados apareça nos logs do WinHTTP.

Para capturar logs do WinHTTP

  1. Abra uma janela de prompt de comandos com privilégios elevados no computador cliente.

  2. Execute o seguinte comando: netsh winhttp set tracing trace-file-prefix="C:\Temp\dpws" level=verbose format=ansi state=enabled max-trace-file-size=1073741824

    Esse comando habilita o registro em log do WinHTTP. Todos os arquivos de log serão armazenados no diretório C:\Temp e os nomes de arquivo começarão com o prefixo dpws. No máximo 1 GB de arquivos de log serão armazenados.

  3. Se o processo que usa WinHTTP no cliente já estiver em execução, reinicie o computador. Por exemplo, se as APIs de Descoberta de Função estiverem sendo usadas, o computador deverá ser reiniciado. As APIs de Descoberta de Função chamam WinHTTP de dentro de um host de serviço, que pode já ter sido iniciado quando o rastreamento foi habilitado.

  4. Inicie o aplicativo cliente baseado em WSDAPI. O aplicativo que está sendo depurado ou o Cliente de Depuração do WSD pode ser usado.

  5. Reproduza a falha do aplicativo.

  6. Encerre o aplicativo cliente baseado em WSDAPI.

  7. Se o processo que usa WinHTTP não for encerrado com o aplicativo cliente, reinicie o computador. Por exemplo, se as APIs de Descoberta de Função estiverem sendo usadas, o computador deverá ser reiniciado.

  8. Execute o seguinte comando: netsh winhttp set tracing state=disabled

    Esse comando desabilita o log do WinHTTP.

  9. Inspecione os logs do DPWS em C:\Temp e verifique se as solicitações e mensagens necessárias foram enviadas.

  10. Se a comunicação https estiver sendo usada, marcar para falhas de SSL/TLS.

Depois que os logs do WinHTTP forem capturados, os logs poderão ser examinados para procurar a causa de uma falha do aplicativo WSDAPI. Observe que o editor de texto usado para exibir esses logs deve ser executado como Administrador. Para obter mais informações, consulte Usando o log do WinHTTP para verificar se há tráfego.