Partager via

Prise en main avec WSDAPI Résolution des problèmes

  • Article

Ce guide de résolution des problèmes contient un ensemble de procédures de diagnostic qui peuvent être utilisées pour identifier la cause des problèmes d’application. Une fois la cause du problème identifiée, les solutions suggérées dans la procédure de diagnostic peuvent être appliquées afin de résoudre le problème.

Il existe deux façons de déterminer la procédure de diagnostic à utiliser. L’une des méthodes consiste à accéder à la page de résolution des problèmes du type de client pour afficher une liste pas à pas des procédures de diagnostic à utiliser pour résoudre les problèmes du client. L’autre méthode consiste à accéder à la référence rapide de résolution des problèmes ci-dessous pour afficher les tables récapitulatives qui montrent les problèmes courants avec les applications WSDAPI et les procédures à utiliser pour diagnostiquer les problèmes.

Résolution des problèmes par type de client

Les rubriques suivantes présentent les procédures de diagnostic pertinentes par type de client. Ces rubriques montrent également les modèles de message associés au type de client.

Résolution des problèmes de référence rapide

Les tableaux suivants montrent certains problèmes qui peuvent empêcher les clients et les hôtes WSDAPI de se voir sur le réseau et d’échanger des métadonnées d’appareil. Les tableaux indiquent également les procédures de diagnostic à exécuter et les critères à utiliser pour déterminer si l’application souffre d’un problème particulier.

Problèmes d’environnement réseau

Problème Procédure de diagnostic Identification du problème
Le pare-feu bloque le trafic de découverte réseau. Inspection des paramètres de l’adaptateur et du pare-feu L’activation de l’exception de découverte réseau sur le pare-feu résout le problème.
Les exceptions de pare-feu spécifiques à l’application bloquent les messages. Inspection des paramètres de l’adaptateur et du pare-feu La désactivation du pare-feu résout le problème. WF.msc affiche des règles de pare-feu spécifiques à l’application.
L’appareil ne répond pas aux demandes UDP en envoyant un message ProbeMatches ou ResolveMatches en temps opportun (moins de 4 secondes). Inspection des paramètres de l’adaptateur et du pare-feu La désactivation du pare-feu résout le problème et un hôte générique qui répond en moins de 4 secondes fonctionne correctement.
Le contexte de sécurité de l’application est incorrect (autrement dit, le client et l’hôte ne disposent pas des autorisations appropriées sur le réseau). Utilisation d’un hôte et d’un client génériques pour la découverte de WS UDP ou utilisation d’un hôte générique et d’un client pour l’échange de métadonnées HTTP L’adresse de l’appareil n’est pas affichée dans la sortie du client de débogage WSD. L’exécution de l’application en tant qu’administrateur résout le problème.
Une stratégie IPSec bloque les messages. Utilisation d’un hôte et d’un client génériques pour la découverte de WS UDP ou utilisation d’un hôte générique et d’un client pour l’échange de métadonnées HTTP L’adresse de l’appareil n’est pas affichée dans la sortie du client de débogage WSD. Le problème n’est pas résolu en désactivant le pare-feu. Le problème ne peut pas être reproduit sur une machine non soumise à des stratégies IPSec.

Problèmes de trafic de découverte

Problème Procédure de diagnostic Identification du problème
Les messages Hello, Probe ou Resolve ne sont pas transmis sur le réseau, car l’application n’énumère pas correctement les interfaces réseau de multidiffusion. Utilisation du client de débogage WSD pour vérifier le trafic de multidiffusion Les messages Hello, Probe ou Resolve n’apparaissent pas dans la sortie du client WSD Debug. Les paquets n’apparaissent pas sur le réseau. Les paquets ne sont pas générés pour l’interface de bouclage ou pour d’autres interfaces.
Les messages de sonde ne sont pas envoyés par multidiffusion UDP au port 3702 (pour les applications qui n’utilisent pas la découverte dirigée). Inspection des traces réseau pour udp WS-Discovery L’inspection du message montre qu’il a été envoyé au mauvais port.
Le message Probe ne contient pas d’élément Types ou l’élément Types est vide. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection du message indique que l’élément Types n’est pas présent ou vide.
L’élément Types d’un message Probe ne contient pas les types auxquels un hôte répond. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection du message montre que l’élément Types contient une valeur incorrecte ou incorrecte.
Un message ProbeMatches n’a pas été envoyé en monodiffusion au port UDP à partir duquel la sonde a été envoyée. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection de la sortie montre qu’aucun message ProbeMatches) n’a été envoyé ou que le message a été envoyé au mauvais port. Note: Pour les applications utilisant la découverte dirigée, les ProbeMatches doivent être envoyés via HTTP ou HTTPS en réponse au message Probe .
Le message ProbeMatches ne contient pas d’élément RelatesTo ou l’élément RelatesTo est vide. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection du message indique que l’élément RelatesTo n’est pas présent ou vide.
La valeur de l’élément RelatesTo dans un message ProbeMatches ne correspond pas à la valeur de l’élément MessageId du message Probe correspondant. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection du message montre que l’élément RelatesTo contient une valeur incorrecte ou incorrecte.
L’élément XAddrs inclus dans un message ProbeMatches n’est pas conforme aux règles de validation XAddr. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection du message montre que les XAddrs ne sont pas valides.
Résoudre les messages ne sont pas envoyés par multidiffusion UDP au port 3702 (pour les applications qui n’utilisent pas la découverte dirigée). Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection de la sortie indique que le message Résoudre a été envoyé au port incorrect.
Un message ResolveMatches n’a pas été envoyé en unidiffusion au port UDP à partir duquel un message Resolve a été envoyé. Inspection des traces réseau pour la découverte de WS UDP ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée L’inspection de la sortie montre qu’aucun message ResolveMatches n’a été envoyé ou que le message a été envoyé au mauvais port.

Problèmes d’échange de métadonnées

Problème Procédure de diagnostic Identification du problème
L’adresse de transport annoncée par l’hôte est incorrecte. Utilisation d’un hôte générique et d’un client pour l’échange de métadonnées HTTP L’inspection des XAddrs dans la sortie du client de débogage WSD montre que l’adresse de transport est incorrecte ou mal formée.
Impossible d’établir une connexion TCP pour l’échange de métadonnées. Inspection des traces réseau pour l’échange de métadonnées HTTP La sortie de l’analyseur de paquets n’affiche pas l’échange de paquets suivant :
  • Paquet TCP SYN envoyé à partir du client
  • Paquet TCP SYN/ACK envoyé à partir de l’hôte
  • Paquet TCP ACK envoyé à partir du client
Le client n’a pas envoyé de requête HTTP GET valide. Inspection des traces réseau pour l’échange de métadonnées HTTP Il n’existe aucune requête HTTP GET dans la sortie de l’analyseur de paquets ou la requête est incorrecte.
Le client n’a pas envoyé de message Get WS-Transfer valide. Inspection des traces réseau pour l’échange de métadonnées HTTP Il n’existe aucune WS-Transfer obtenir le message dans la sortie de l’analyseur de paquets, ou le message est mal formé.
L’hôte n’écoute pas sur le chemin d’URL spécifié dans la requête HTTP GET. Inspection des traces réseau pour l’échange de métadonnées HTTP Il n’existe aucune réponse HTTP dans la sortie de l’analyseur de paquets.
Le WS-Transfer message Get ne contient pas d’élément To , ou l’élément To est vide. Inspection des traces réseau pour l’échange de métadonnées HTTP L’inspection du message indique que l’élément To n’est pas présent ou vide.
La valeur de l’élément To d’un message WS-Transfer Obtenir ne correspond pas à l’une des adresses de point de terminaison de l’hôte. Inspection des traces réseau pour l’échange de métadonnées HTTP L’inspection du message montre que la valeur de l’élément To ne correspond pas à l’une des adresses de point de terminaison publiées dans le message ProbeMatches ou ResolveMatches de l’hôte.
L’hôte n’a pas envoyé d’en-tête de réponse HTTP valide. Inspection des traces réseau pour l’échange de métadonnées HTTP Il n’existe aucune réponse HTTP dans la sortie de l’analyseur de paquets, ou la requête est incorrecte.
L’en-tête de réponse HTTP envoyé par l’hôte indique que la requête ne peut pas être effectuée. Inspection des traces réseau pour l’échange de métadonnées HTTP L’en-tête de réponse a un code status autre que HTTP/1.1 200.
L’hôte n’a pas envoyé de message GetResponse valide. Inspection des traces réseau pour l’échange de métadonnées HTTP Il n’existe aucun message GetResponse dans la sortie de l’analyseur de paquets, ou le message est mal formé.
Le message GetResponse ne contient pas d’élément RelatesTo ou l’élément RelatesTo est vide. Inspection des traces réseau pour l’échange de métadonnées HTTP L’inspection du message indique que l’élément RelatesTo n’est pas présent ou vide.
La valeur de l’élément RelatesTo dans un message GetResponse ne correspond pas à la valeur de l’élément MessageId du message Get correspondant. Inspection des traces réseau pour l’échange de métadonnées HTTP L’inspection du message montre que l’élément RelatesTo contient une valeur incorrecte ou incorrecte.

Guide de résolution des problèmes WSDAPI