Résolution des problèmes de Prise en main avec WSDAPI
Ce guide de dépannage contient un ensemble de procédures de diagnostic qui peuvent être utilisées pour aider à 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 pour le type de client pour afficher une liste pas à pas des procédures de diagnostic à utiliser pour dépanner le client. L’autre méthode consiste à accéder à la aide-mémoire de dépannage ci-dessous pour afficher des tableaux récapitulatifs qui présentent des problèmes courants avec les applications WSDAPI et les procédures à suivre pour diagnostiquer les problèmes.
Résolution des problèmes par type de client
Les rubriques suivantes présentent les procédures de diagnostic appropriées par type de client. Ces rubriques affichent également les modèles de message associés au type de client.
- Dépannage des applications WSDAPI à l’aide de la découverte dirigée
- Résolution des problèmes des clients de découverte des fonctions
- Résolution des problèmes voisinage immédiat/réunions près de moi
- Résolution des problèmes liés à l’Assistant Ajout d’imprimante
- Résolution des problèmes de l’Explorateur réseau
- Résolution des problèmes de l’Assistant projecteur
- Résolution des problèmes liés aux autres applications WSDAPI
Aide-mémoire pour la résolution des problèmes
Les tableaux suivants présentent certains problèmes qui peuvent empêcher les clients et hôtes WSDAPI de se voir sur le réseau et d’échanger des métadonnées d’appareil. Les tables affichent également les procédures de diagnostic à exécuter et les critères à utiliser pour évaluer si l’application subit 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 du réseau. | inspection des Paramètres de l’adaptateur et du pare-feu | L’activation de l’exception découverte du 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 les règles de pare-feu spécifiques à l’application. |
| L’appareil ne répond pas aux demandes UDP en envoyant un message messages 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 adéquates sur le réseau). | Utilisation d’un hôte et d’un client génériques pour UDP WS-Discovery ou utilisation d’un hôte et d’un client génériques pour les métadonnées http Exchange | 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 UDP WS-Discovery ou utilisation d’un hôte et d’un client génériques pour les métadonnées http Exchange | 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 qui n’est soumise à aucune stratégie IPSec. |
Problèmes de trafic de découverte
| Problème | Procédure de diagnostic | Identification du problème |
|---|---|---|
| Les messages Hello, Probeou 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 de débogage WSD. 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 sondage ne sont pas envoyés par la multidiffusion UDP au port 3702 (pour les applications qui n’utilisent pas la découverte dirigée). | Inspection des suivis réseau pour UDP WS-Discovery | L’inspection du message indique qu’il a été envoyé au mauvais port. |
| Le message de sondage ne contient pas d’élément types , ou l’élément types est vide. | Inspection des suivis réseau pour UDP WS-Discovery 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 de sonde ne contient pas les types auxquels un hôte doit répondre. | Inspection des suivis réseau pour UDP WS-Discovery 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 contient une valeur incorrecte ou incorrecte. |
| Un message messages ProbeMatches n’a pas été envoyé en monodiffusion au port UDP à partir duquel la sonde a été envoyée. | Inspection des suivis réseau pour UDP WS-Discovery ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée | L’inspection de la sortie indique qu’aucun message messages ProbeMatches) n’a été envoyé ou que le message a été envoyé au mauvais port.[!Note] |
| Le message messages ProbeMatches ne contient pas d’élément latesto , ou l’élément latesto est vide. | Inspection des suivis réseau pour UDP WS-Discovery 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 latesto n’est pas présent ou vide. |
| La valeur de l’élément latesto dans un message messages ProbeMatches ne correspond pas à la valeur de l’élément MessageID du message de sondage correspondant. | Inspection des suivis réseau pour UDP WS-Discovery 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 latesto contient une valeur incorrecte ou incorrecte. |
| L’élément XAddrs inclus dans un message messages ProbeMatches n’est pas conforme aux règles de validation XAddr. | Inspection des suivis réseau pour UDP WS-Discovery ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée | L’inspection du message indique que les XAddrs ne sont pas valides. |
| La résolution des messages n’est pas envoyée par la multidiffusion UDP au port 3702 (pour les applications qui n’utilisent pas la découverte dirigée). | Inspection des suivis réseau pour UDP WS-Discovery 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 de résolution a été envoyé au mauvais port. |
| Un message ResolveMatches n’a pas été envoyé en monodiffusion au port UDP à partir duquel un message de résolution a été envoyé. | Inspection des suivis réseau pour UDP WS-Discovery ou inspection des traces réseau pour les applications à l’aide de la découverte dirigée | L’inspection de la sortie indique 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 publiée par l’hôte est incorrecte. | Utilisation d’un hôte et d’un client génériques pour les métadonnées HTTP Exchange | L’inspection de XAddrs dans la sortie du client de débogage WSD indique que l’adresse de transport est incorrecte ou incorrecte. |
| Impossible d’établir une connexion TCP pour l’échange de métadonnées. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | La sortie de l’analyseur de paquets n’affiche pas l’échange de paquets suivant :
|
| Le client n’a pas envoyé de requête HTTP obtenir valide. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | Il n’y a aucune requête HTTP d’extraction dans la sortie de l’analyseur de paquets, ou la requête est incorrecte. |
| Le client n’a pas envoyé de message d' WS-Transfer d' extraction valide. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | Il n’existe aucun WS-Transfer recevoir de message dans la sortie de l’analyseur de paquets, ou le message est incorrect. |
| L’hôte n’écoute pas sur le chemin d’accès de l’URL spécifié dans la requête HTTP. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | Il n’y a aucune réponse HTTP dans la sortie de l’analyseur de paquets. |
| Le WS-Transfer obtenir le message ne contient pas d’élément à , ou l’élément à est vide. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | 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 WS-Transfer obtenir le message ne correspond pas à l’une des adresses de point de terminaison de l’hôte. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | L’inspection du message indique que la valeur de l’élément to ne correspond pas à l’une des adresses de point de terminaison publiées dans le message messages 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 suivis réseau pour les métadonnées HTTP Exchange | Il n’y a 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 demande ne peut pas être terminée. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | L’en-tête de réponse a un code d’État autre que HTTP/1.1 200. |
| L’hôte n’a pas envoyé de message GetResponse valide. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | Il n’existe aucun message GetResponse dans la sortie de l’analyseur de paquets ou le message est incorrect. |
| Le message GetResponse ne contient pas d’élément latesto , ou l’élément latesto est vide. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | L’inspection du message indique que l’élément latesto n’est pas présent ou vide. |
| La valeur de l’élément latesto dans un message GetResponse ne correspond pas à la valeur de l’élément MessageID du message d' extraction correspondant. | Inspection des suivis réseau pour les métadonnées HTTP Exchange | L’inspection du message indique que l’élément latesto contient une valeur incorrecte ou incorrecte. |