Delen via


Aan de slag met WSDAPI-probleemoplossing

Deze gids voor probleemoplossing bevat een set diagnostische procedures die kunnen worden gebruikt om de oorzaak van toepassingsproblemen te identificeren. Zodra de oorzaak van het probleem is geïdentificeerd, kunnen de voorgestelde oplossingen in de diagnostische procedure worden toegepast om het probleem op te lossen.

Er zijn twee manieren om de diagnostische procedure te bepalen die moet worden gebruikt. Een manier is om naar de pagina voor probleemoplossing te gaan voor het type client om een stapsgewijze lijst met diagnostische procedures weer te geven die moeten worden gebruikt om problemen met de client op te lossen. U kunt ook naar de onderstaande snelzoekgids voor probleemoplossing gaan om overzichtstabellen weer te geven met veelvoorkomende problemen met WSDAPI-toepassingen en de procedures die moeten worden gebruikt om de problemen vast te stellen.

Problemen oplossen op type client

In de volgende onderwerpen worden de relevante diagnostische procedures per type client weergegeven. In deze onderwerpen worden ook de berichtpatronen weergegeven die zijn gekoppeld aan het clienttype.

Snelzoekgids voor probleemoplossing

In de volgende tabellen ziet u enkele problemen die kunnen voorkomen dat WSDAPI-clients en -hosts elkaar in het netwerk kunnen zien en metagegevens van apparaten kunnen uitwisselen. In de tabellen worden ook de diagnostische procedures weergegeven die moeten worden uitgevoerd en de criteria die moeten worden gebruikt om te evalueren of de toepassing een bepaald probleem ondervindt.

Problemen met de netwerkomgeving

Probleem Diagnostische procedure Probleemidentificatie
De firewall blokkeert netwerkdetectieverkeer. adapter- en firewallinstellingen controleren Als u de uitzondering voor netwerkdetectie op de firewall inschakelt, wordt het probleem opgelost.
Firewall-uitzonderingen die specifiek zijn voor de toepassing blokkeren berichten. adapter- en firewallinstellingen controleren Als u de firewall uitschakelt, wordt het probleem opgelost. WF.msc toont toepassingsspecifieke firewallregels.
Het apparaat reageert niet binnen de vereiste tijd (minder dan 4 seconden) op UDP-verzoeken door een ProbeMatches- of ResolveMatches bericht te verzenden. adapter- en firewallinstellingen controleren Als u de firewall uitschakelt, wordt het probleem opgelost en werkt een generieke host die in minder dan 4 seconden reageert succesvol.
De beveiligingscontext van de toepassing is onjuist (dat wil gezegd: de client en host hebben niet voldoende machtigingen voor het netwerk). Een algemene host en client gebruiken voor UDP WS-Discovery of een algemene host en client gebruiken voor HTTP Metadata Exchange Het apparaatadres wordt niet weergegeven in WSD-foutopsporingsclientuitvoer. Het probleem wordt opgelost door de toepassing uit te voeren als beheerder.
Een IPSec-beleid blokkeert berichten. Een algemene host en client gebruiken voor UDP WS-Discovery- of met behulp van een algemene host en client voor HTTP Metadata Exchange Het apparaatadres wordt niet weergegeven in WSD-foutopsporingsclientuitvoer. Het probleem wordt niet opgelost door de firewall uit te schakelen. Het probleem kan niet worden gereproduceerd op een computer waarop geen IPSec-beleid van toepassing is.

Problemen met detectieverkeer

Probleem Diagnostische procedure Probleemidentificatie
Hello, Probeof Resolve berichten worden niet op het netwerk verzonden omdat de toepassing de multicastnetwerkinterfaces niet correct opsomt. WSD-foutopsporingsclient gebruiken om multicast-verkeer te verifiëren De berichten Hello, Probe of Resolve worden niet weergegeven in de WSD-uitvoer van de client voor foutopsporing. De pakketten worden niet weergegeven in het netwerk. Pakketten worden niet gegenereerd voor de loopback-interface of voor andere interfaces.
-berichten worden niet met UDP-multicast naar poort 3702 verzonden (voor toepassingen die geen gebruikmaken van gerichte detectie). netwerktraceringen controleren op UDP WS-Discovery- Inspectie van het bericht geeft aan dat het is verzonden naar de verkeerde poort.
Het Probe-bericht bevat geen Types-element of het Types-element is leeg. Netwerktraceringen inspecteren voor UDP WS-Discovery of Netwerktraceringen inspecteren voor toepassingen die gebruikmaken van gerichte detectie In de inspectie van het bericht ziet u dat het element Typen niet aanwezig of leeg is.
Het Types element van een Probe-bericht bevat niet de types waarop een host zal reageren. Netwerktraces inspecteren voor UDP WS-Discovery of netwerktraces inspecteren voor toepassingen met behulp van gerichte detectie Inspectie van het bericht toont aan dat het element types een onjuiste of niet-correcte waarde bevat.
Een ProbeMatches bericht is niet unicast verzonden naar de UDP-poort van waaruit de Probe is verzonden. netwerktraceringen inspecteren voor UDP WS-Discovery of netwerktraceringen inspecteren voor applicaties die gebruikmaken van gerichte detectie Uit de inspectie van de uitvoer blijkt dat er geen ProbeMatches) bericht is verzonden of dat het naar de verkeerde poort is gegaan. Opmerking: Voor toepassingen die gerichte detectie gebruiken, moet de ProbeMatches- worden verzonden via HTTP of HTTPS als reactie op het bericht Probe.
Het ProbeMatches-bericht bevat geen RelatesTo-element of het RelatesTo-element is leeg. Netwerktraceringen inspecteren voor UDP WS-Discovery of Netwerktraceringen inspecteren voor toepassingen die gebruikmaken van gerichte detectie Uit inspectie van het bericht blijkt dat het element RelateertAan niet aanwezig of leeg is.
De waarde van het RelateertAan element in een ProbeMatches bericht komt niet overeen met de waarde van het MessageId-element van het bijbehorende Probe-bericht. netwerktraceringen controleren op UDP WS-Discovery- of netwerktraceringen inspecteren voor toepassingen met behulp van gerichte detectie Bij inspectie van het bericht blijkt dat het element RelatesTo een onjuiste of verkeerde waarde bevat.
Het XAddrs-element dat is opgenomen in een ProbeMatches bericht voldoet niet aan de XAddr-validatieregels. Netwerktraceringen inspecteren voor UDP WS-Discovery of netwerktraceringen inspecteren voor toepassingen middels gerichte detectie Inspectie van het bericht geeft aan dat de XAddrs- ongeldig zijn.
-berichten worden niet verzonden via UDP multicast naar poort 3702 (voor toepassingen die geen gebruik maken van gerichte detectie). netwerktraceringen inspecteren voor UDP WS-Discovery of netwerktraceringen inspecteren voor applicaties met behulp van gerichte detectie In de uitvoer ziet u dat het bericht is verzonden naar de verkeerde poort.
Een ResolveMatches bericht is niet unicast verzonden naar de UDP-poort van waaruit een Resolve bericht is verzonden. netwerktraceringen inspecteren voor UDP WS-Discovery of netwerktraceringen inspecteren voor toepassingen die gerichte detectie gebruiken Controle van de uitvoer geeft aan dat er geen ResolveMatches bericht is verzonden of dat het bericht naar de verkeerde poort is verzonden.

Problemen met het uitwisselen van metagegevens

Probleem Diagnostische procedure Probleemidentificatie
Het transportadres dat door de host wordt aangekondigd, is onjuist. Een algemene host en client gebruiken voor HTTP Metadata Exchange- Inspectie van de XAddrs in de uitvoer van de WSD-debugclient toont aan dat het transportadres onjuist of vervormd is.
Er kan geen TCP-verbinding tot stand worden gebracht voor het uitwisselen van metagegevens. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren De uitvoer van de pakketanalyse toont niet de volgende pakketuitwisseling:
  • Een TCP SYN-pakket dat vanaf de client wordt verzonden
  • Een TCP SYN/ACK-pakket dat vanaf de host wordt verzonden
  • Een TCP ACK-pakket dat vanaf de client wordt verzonden
De client heeft geen geldige HTTP GET-aanvraag verzonden. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Er is geen HTTP GET-aanvraag in de uitvoer van pakketanalyse of de aanvraag is onjuist ingedeeld.
De cliënt heeft geen geldig WS-Transfer Get-bericht verzonden. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Er is geen WS-Transfer -bericht in de uitvoer van de pakketanalyzer, of het bericht is niet correct gevormd.
De host luistert niet op het URL-pad dat is opgegeven in de HTTP GET-aanvraag. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Er is geen HTTP-antwoord in de uitvoer van pakketanalyse.
Het WS-Transfer bericht ophalen bevat geen Element Aan of het Element Aan is leeg. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Uit inspectie van het bericht is gebleken dat het element tot niet aanwezig ofwel leeg is.
De waarde van het -naar--element van een WS-Transfer ophalenbericht komt niet overeen met een van de eindpuntadressen van de host. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Inspectie van het bericht toont aan dat de waarde van het element tot niet overeenkomt met een van de eindpuntadressen die in het ProbeMatches of ResolveMatches bericht van de host worden geadverteerd.
De host heeft geen geldige HTTP-antwoordheader verzonden. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Er is geen HTTP-antwoord in de uitvoer van de pakketanalyse of de aanvraag is ongeldig.
De HTTP-antwoordheader die door de host wordt verzonden, geeft aan dat de aanvraag niet kan worden voltooid. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren De antwoordheader heeft een andere statuscode dan HTTP/1.1 200.
De host heeft geen geldig GetResponse--bericht verzonden. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Er is geen GetResponse- bericht in de uitvoer van de pakketanalyzer, of het bericht is vervormd.
Het bericht GetResponse- bevat geen RelatesTo-element of het RelatesTo-element is leeg. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Uit inspectie van het bericht blijkt dat het element RelateertAan niet aanwezig of leeg is.
De waarde van het RelatesTo-element in een GetResponse--bericht komt niet overeen met de waarde van het MessageId-element uit het bijbehorende Get-bericht. netwerktraceringen voor HTTP-metagegevensuitwisseling controleren Inspectie van het bericht toont aan dat het element RelatesTo een onjuiste of incorrecte waarde bevat.

Probleemoplossingsgids voor WSDAPI