Compartilhar via


Introdução com solução de problemas do WSDAPI

Este guia de solução de problemas contém um conjunto de procedimentos de diagnóstico que podem ser usados para ajudar a identificar a causa dos problemas do aplicativo. Depois que a causa do problema for identificada com êxito, as soluções sugeridas no procedimento de diagnóstico poderão ser aplicadas para resolve o problema.

Há duas maneiras de determinar o procedimento de diagnóstico a ser usado. Uma maneira é acessar a página de solução de problemas do tipo de cliente para exibir uma lista passo a passo de procedimentos de diagnóstico a serem usados para solucionar problemas do cliente. A outra maneira é ir para a referência rápida de solução de problemas abaixo para exibir tabelas de resumo que mostram problemas comuns com aplicativos WSDAPI e os procedimentos a serem usados para diagnosticar os problemas.

Solução de problemas por tipo de cliente

Os tópicos a seguir mostram os procedimentos de diagnóstico relevantes por tipo de cliente. Esses tópicos também mostram os padrões de mensagem associados ao tipo de cliente.

Solução de problemas de referência rápida

As tabelas a seguir mostram alguns problemas que podem impedir que clientes e hosts WSDAPI vejam uns aos outros na rede e troquem metadados do dispositivo. As tabelas também mostram os procedimentos de diagnóstico a serem executados e os critérios a serem usados para avaliar se o aplicativo sofre de um problema específico.

Problemas de ambiente de rede

Problema Procedimento de diagnóstico Identificação do problema
O firewall bloqueia o tráfego de Descoberta de Rede. Inspecionando as configurações do adaptador e do firewall Habilitar a exceção de Descoberta de Rede no firewall resolve o problema.
Exceções de firewall específicas ao aplicativo estão bloqueando mensagens. Inspecionando as configurações do adaptador e do firewall Desabilitar o firewall resolve o problema. O WF.msc mostra regras de firewall específicas do aplicativo.
O dispositivo não responde a solicitações UDP enviando uma mensagem ProbeMatches ou ResolveMatches em tempo hábil (menos de 4 segundos). Inspecionando as configurações do adaptador e do firewall Desabilitar o firewall resolve o problema e um host genérico que responde em menos de 4 segundos funciona com êxito.
O contexto de segurança do aplicativo está incorreto (ou seja, o cliente e o host não têm permissões adequadas na rede). Usando um host genérico e um cliente para UDP WS-Discovery ou usando um host genérico e um cliente para a troca de metadados HTTP O endereço do dispositivo não é mostrado na saída do cliente de depuração do WSD. Executar o aplicativo como Administrador resolve o problema.
Uma política IPSec está bloqueando mensagens. Usando um host genérico e um cliente para UDP WS-Discovery ou usando um host genérico e um cliente para a troca de metadados HTTP O endereço do dispositivo não é mostrado na saída do cliente de depuração do WSD. O problema não é resolvido desabilitando o firewall. O problema não pode ser reproduzido em um computador que não está sujeito a nenhuma política IPSec.

Problemas de tráfego de descoberta

Problema Procedimento de diagnóstico Identificação do problema
As mensagens Hello, Probe ou Resolve não são transmitidas na rede porque o aplicativo não enumera corretamente os adaptadores de rede multicast. Usar o cliente de depuração do WSD para verificar o tráfego multicast As mensagens Hello, Probe ou Resolve não aparecem na saída do Cliente de Depuração do WSD. Os pacotes não aparecem na rede. Os pacotes não são gerados para a interface de loopback ou para outras interfaces.
As mensagens de investigação não são enviadas por multicast UDP para a porta 3702 (para aplicativos que não usam a descoberta direcionada). Inspecionando rastreamentos de rede para descoberta de WS do UDP A inspeção da mensagem mostra que ela foi enviada para a porta errada.
A mensagem Probe não contém um elemento Types ou o elemento Types está vazio. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da mensagem mostra que o elemento Types não está presente ou vazio.
O elemento Types de uma mensagem probe não contém os tipos aos quais um host responderá. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da mensagem mostra que o elemento Types contém um valor malformado ou incorreto.
Uma mensagem ProbeMatches não foi enviada unicast para a porta UDP da qual a investigação foi enviada. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da saída mostra que nenhuma mensagem ProbeMatches) foi enviada ou que a mensagem foi enviada para a porta errada. Nota: Para aplicativos que usam a descoberta direcionada, o ProbeMatches deve ser enviado por HTTP ou HTTPS em resposta à mensagem De investigação.
A mensagem ProbeMatches não contém um elemento RelatesTo ou o elemento RelatesTo está vazio. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da mensagem mostra que o elemento RelatesTo não está presente ou vazio.
O valor do elemento RelatesTo em uma mensagem ProbeMatches não corresponde ao valor do elemento MessageId da mensagem probe correspondente. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da mensagem mostra que o elemento RelatesTo contém um valor malformado ou incorreto.
O elemento XAddrs incluído em uma mensagem ProbeMatches não está em conformidade com as Regras de Validação XAddr. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da mensagem mostra que os XAddrs são inválidos.
As mensagens de resolução não são enviadas por multicast UDP para a porta 3702 (para aplicativos que não usam a descoberta direcionada). Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da saída mostra que a mensagem Resolver foi enviada para a porta errada.
Uma mensagem ResolveMatches não foi enviada unicast para a porta UDP da qual uma mensagem Resolve foi enviada. Inspecionando rastreamentos de rede para descoberta de WS UDP ou inspecionando rastreamentos de rede para aplicativos usando descoberta direcionada A inspeção da saída mostra que nenhuma mensagem ResolveMatches foi enviada ou que a mensagem foi enviada para a porta errada.

Problemas de troca de metadados

Problema Procedimento de diagnóstico Identificação do problema
O endereço de transporte anunciado pelo host está errado. Usando um host genérico e um cliente para a troca de metadados HTTP A inspeção dos XAddrs na saída do Cliente de Depuração do WSD mostra que o endereço de transporte está incorreto ou malformado.
Não foi possível estabelecer uma conexão TCP para troca de metadados. Inspecionando rastreamentos de rede para troca de metadados HTTP A saída do analisador de pacotes não mostra a seguinte troca de pacotes:
  • Um pacote TCP SYN enviado do cliente
  • Um pacote TCP SYN/ACK enviado do host
  • Um pacote TCP ACK enviado do cliente
O cliente não enviou uma solicitação HTTP GET válida. Inspecionando rastreamentos de rede para troca de metadados HTTP Não há nenhuma solicitação HTTP GET na saída do analisador de pacotes ou a solicitação está malformada.
O cliente não enviou uma mensagem válida WS-Transfer Obter . Inspecionando rastreamentos de rede para troca de metadados HTTP Não há WS-Transfer Obter mensagem na saída do analisador de pacotes ou a mensagem está malformada.
O host não está escutando no caminho da URL especificado na solicitação HTTP GET. Inspecionando rastreamentos de rede para troca de metadados HTTP Não há resposta HTTP na saída do analisador de pacotes.
O WS-Transfer mensagem Get não contém um elemento To ou o elemento To está vazio. Inspecionando rastreamentos de rede para troca de metadados HTTP A inspeção da mensagem mostra que o elemento To não está presente ou vazio.
O valor do elemento To de um WS-Transfer mensagem Get não corresponde a um dos endereços do ponto de extremidade do host. Inspecionando rastreamentos de rede para troca de metadados HTTP A inspeção da mensagem mostra que o valor do elemento To não corresponde a um dos endereços de ponto de extremidade anunciados na mensagem ProbeMatches ou ResolveMatches do host.
O host não enviou um cabeçalho de resposta HTTP válido. Inspecionando rastreamentos de rede para troca de metadados HTTP Não há resposta HTTP na saída do analisador de pacotes ou a solicitação está malformada.
O cabeçalho de resposta HTTP enviado pelo host indica que a solicitação não pode ser concluída. Inspecionando rastreamentos de rede para troca de metadados HTTP O cabeçalho de resposta tem um código status diferente de HTTP/1.1 200.
O host não enviou uma mensagem GetResponse válida. Inspecionando rastreamentos de rede para troca de metadados HTTP Não há nenhuma mensagem GetResponse na saída do analisador de pacotes ou a mensagem está malformada.
A mensagem GetResponse não contém um elemento RelatesTo ou o elemento RelatesTo está vazio. Inspecionando rastreamentos de rede para troca de metadados HTTP A inspeção da mensagem mostra que o elemento RelatesTo não está presente ou vazio.
O valor do elemento RelatesTo em uma mensagem GetResponse não corresponde ao valor do elemento MessageId da mensagem Get correspondente. Inspecionando rastreamentos de rede para troca de metadados HTTP A inspeção da mensagem mostra que o elemento RelatesTo contém um valor malformado ou incorreto.

Guia de solução de problemas do WSDAPI