Udostępnij przez

Wprowadzenie do rozwiązywania problemów z interfejsem WSDAPI

Ten przewodnik rozwiązywania problemów zawiera zestaw procedur diagnostycznych , które mogą służyć do identyfikowania przyczyny problemów z aplikacją. Po pomyślnym zidentyfikowaniu przyczyny problemu można zastosować sugerowane rozwiązania w procedurze diagnostycznej w celu rozwiązania problemu.

Istnieją dwa sposoby określania procedury diagnostycznej do użycia. Jednym ze sposobów jest przejście do strony rozwiązywania problemów dla typu klienta, aby wyświetlić listę krok po kroku procedur diagnostycznych, które mają być używane do rozwiązywania problemów z klientem. Drugi sposób polega na przejściu do poniższej krótkiej dokumentacji rozwiązywania problemów, aby wyświetlić tabele podsumowania, które pokazują typowe problemy z aplikacjami WSDAPI i procedurami używanymi do diagnozowania problemów.

Rozwiązywanie problemów według typu klienta

W poniższych tematach przedstawiono odpowiednie procedury diagnostyczne według typu klienta. W tych tematach przedstawiono również wzorce komunikatów skojarzone z typem klienta.

Szybki przewodnik rozwiązywania problemów

W poniższych tabelach przedstawiono niektóre problemy, które mogą uniemożliwić klientom i hostom WSDAPI wyświetlanie siebie nawzajem w sieci oraz wymianę metadanych urządzenia. W tabelach przedstawiono również procedury diagnostyczne do uruchomienia oraz kryteria, których należy użyć do oceny, czy aplikacja cierpi na konkretny problem.

Problemy ze środowiskiem sieci

Problem Procedura diagnostyczna Identyfikacja problemu
Zapora blokuje ruch odnajdywania sieci. sprawdzanie ustawień adaptera i zapory Włączenie wyjątku odnajdywania sieci w zaporze rozwiązuje problem.
Wyjątki zapory specyficzne dla aplikacji blokują komunikaty. Inspekcja ustawień adaptera i zapory Wyłączenie zapory rozwiązuje problem. WF.msc pokazuje reguły zapory specyficzne dla aplikacji.
Urządzenie nie odpowiada na żądania UDP przez wysyłanie komunikatu ProbeMatches lub ResolveMatches w krótszym czasie (mniej niż 4 sekundy). Sprawdzanie ustawień adaptera i zapory Wyłączenie zapory rozwiązuje problem, a ogólny host, który odpowiada w mniej niż 4 sekundy, działa pomyślnie.
Kontekst zabezpieczeń aplikacji jest niepoprawny (czyli klient i host nie mają odpowiednich uprawnień w sieci). używanie hosta ogólnego i klienta dla odnajdywania UDP WS-Discovery lub przy użyciu hosta ogólnego i klienta na potrzeby wymiany metadanych HTTP Adres urządzenia nie jest wyświetlany w danych wyjściowych klienta debugowania usługi WSD. Uruchomienie aplikacji jako administrator rozwiązuje problem.
Zasady protokołu IPSec blokują komunikaty. używanie hosta ogólnego i klienta dla odnajdywania UDP WS-Discovery lub przy użyciu hosta ogólnego i klienta na potrzeby wymiany metadanych HTTP Adres urządzenia nie jest wyświetlany w danych wyjściowych klienta debugowania usługi WSD. Problem nie został rozwiązany przez wyłączenie zapory. Nie można odtworzyć problemu na maszynie, która nie podlega żadnym zasadom protokołu IPSec.

Problemy z ruchem sieciowym discovery

Problem Procedura diagnostyczna Identyfikacja problemu
Komunikaty Hello, Probelub Resolve nie są przesyłane w sieci, ponieważ aplikacja niepoprawnie wylicza interfejsy sieciowe multicast. Wykorzystanie klienta debugowania WSD do weryfikacji ruchu multicastowego Komunikaty Hello, Probe lub Resolve nie są wyświetlane w danych wyjściowych klienta debugowania usługi WSD. Pakiety nie są wyświetlane w sieci. Pakiety nie są generowane dla interfejsu loopback ani dla innych interfejsów.
komunikaty sondy nie są wysyłane przez multiemisję UDP do portu 3702 (w przypadku aplikacji, które nie używają odnajdywania kierowanego). Inspekcja śladów sieci dla odnajdywania UDP WS-Discovery Inspekcja komunikatu pokazuje, że został wysłany do nieprawidłowego portu.
Komunikat sondy nie zawiera elementu Types lub element Types jest pusty. Inspekcja śladów sieci dla WS-Discovery UDP lub Inspekcja śladów sieci dla aplikacji wykorzystujących Direct Discovery Inspekcja komunikatu pokazuje, że element Types nie jest obecny ani pusty.
Element Types komunikatu sondy nie zawiera typów, na które będzie odpowiadać host. Inspekcja śladów sieciowych dla UDP WS-Discovery lub Inspekcja śladów sieciowych dla aplikacji korzystających z bezpośredniego odnajdywania Inspekcja komunikatu pokazuje, że element Types zawiera źle sformułowaną lub niepoprawną wartość.
Komunikat ProbeMatches nie został wysłany jednokierunkowo do portu UDP, z którego została wysłana sonda . Inspekcja śladów sieci dla odkrywania usług UDP w WS-Discovery lub Inspekcja śladów sieci dla aplikacji wykorzystujących bezpośrednie odnajdywanie Inspekcja danych wyjściowych pokazuje, że nie wysłano komunikatu ProbeMatches) lub że wiadomość została wysłana do nieprawidłowego portu. Uwaga: W przypadku aplikacji korzystających z odnajdywania kierowanego ProbeMatches należy wysłać za pośrednictwem protokołu HTTP lub HTTPS w odpowiedzi na komunikat Probe.
Komunikat ProbeMatches nie zawiera elementu RelatesTo lub element RelatesTo jest pusty. Inspekcja śladów sieci dla UDP WS-Discovery lub Inspekcja śladów sieci dla aplikacji używających skierowanego odnajdywania Inspekcja komunikatu pokazuje, że element RelatesTo nie jest obecny ani pusty.
Wartość elementu RelatesTo w komunikacie ProbeMatches nie jest zgodna z wartością elementu MessageId z odpowiedniego komunikatu Probe. Analiza śladów sieci dla protokołu UDP WS-Discovery lub Analiza śladów sieci dla aplikacji z użyciem bezpośredniego odnajdywania Inspekcja komunikatu pokazuje, że element RelatesTo zawiera źle sformułowaną lub niepoprawną wartość.
Element XAddrs dołączony do komunikatu ProbeMatches nie jest zgodny z regułami weryfikacji XAddr XAddr. Inspekcja śladów sieci dla protokołu WS-Discovery UDP lub Inspekcja śladów sieci dla aplikacji z użyciem bezpośredniego odnajdywania Kontrola wiadomości pokazuje, że XAddrs są nieprawidłowe.
Komunikaty rozwiązywania nie są wysyłane przez UDP przy użyciu multiemisji na port 3702 (w przypadku aplikacji, które nie korzystają z odnajdywania kierowanego). Przeglądanie śladów sieci dla protokołu WS-Discovery UDP lub Przeglądanie śladów sieci dla aplikacji przy użyciu mechanizmu bezpośredniego odnajdywania Inspekcja danych wyjściowych pokazuje, że komunikat Resolve został wysłany do nieprawidłowego portu.
Komunikat ResolveMatches nie został wysłany unicastowo do portu UDP, z którego został wysłany komunikat Resolve. Analiza śladów sieci dla protokołu UDP WS-Discovery lub Analiza śladów sieci dla aplikacji korzystających z bezpośredniego odnajdywania Inspekcja danych wyjściowych pokazuje, że nie wysłano komunikatu ResolveMatches lub że wiadomość została wysłana do nieprawidłowego portu.

Problemy z wymianą metadanych

Problem Procedura diagnostyczna Identyfikacja problemu
Adres transportu anonsowany przez hosta jest nieprawidłowy. Używanie uniwersalnego hosta i klienta do wymiany metadanych HTTP Sprawdzenie XAddrs w danych wyjściowych klienta debugowania WSD pokazuje, że adres transportowy jest nieprawidłowy lub źle sformułowany.
Nie można ustanowić połączenia TCP dla wymiany metadanych. Inspekcja śladów sieci w celu wymiany metadanych HTTP Dane wyjściowe analizatora pakietów nie pokazują następującej wymiany pakietów:
  • Pakiet TCP SYN wysłany z klienta
  • Pakiet TCP SYN/ACK wysłany z hosta
  • Pakiet TCP ACK wysłany z klienta
Klient nie wysłał prawidłowego żądania HTTP GET. Inspekcja śladów sieci w sprawie wymiany metadanych HTTP Brak żądania HTTP GET w danych wyjściowych analizatora pakietów lub żądanie jest źle sformułowane.
Klient nie wysłał prawidłowego komunikatu WS-Transfer Get. Analiza śladów sieci pod kątem wymiany metadanych HTTP W danych wyjściowych analizatora pakietów nie ma komunikatu WS-Transfer Get lub komunikat jest źle sformułowany.
Host nie nasłuchuje na ścieżce adresu URL określonej w żądaniu HTTP GET. Inspekcja śladów sieciowych w celu wymiany metadanych HTTP W danych wyjściowych analizatora pakietów nie ma odpowiedzi HTTP.
Komunikat get WS-Transfer nie zawiera elementu To lub element To jest pusty. Analizowanie śladów sieciowych pod kątem wymiany metadanych HTTP Inspekcja komunikatu pokazuje, że element To nie jest obecny ani pusty.
Wartość elementu To w komunikacie WS-Transfer Get nie pasuje do żadnego z adresów końcowych hosta. Analiza śladów ruchu sieciowego dla wymiany metadanych HTTP Analiza komunikatu wskazuje, że wartość elementu To nie jest zgodna z jednym z ogłoszonych adresów końcowych w komunikacie ProbeMatches hosta lub ResolveMatches.
Host nie wysłał prawidłowego nagłówka odpowiedzi HTTP. Analizowanie śladów sieciowych w celu wymiany metadanych HTTP Brak odpowiedzi HTTP w danych wyjściowych analizatora pakietów lub żądanie jest źle sformułowane.
Nagłówek odpowiedzi HTTP wysłany przez hosta wskazuje, że nie można ukończyć żądania. Analiza śladów sieciowych w celu wymiany metadanych HTTP Nagłówek odpowiedzi ma kod stanu inny niż HTTP/1.1 200.
Host nie wysłał prawidłowego komunikatu GetResponse. Inspekcja śladów sieci w kontekście wymiany metadanych HTTP Brak komunikatu GetResponse w danych wyjściowych analizatora pakietów lub komunikat jest źle sformułowany.
Komunikat GetResponse nie zawiera elementu RelatesTo lub element RelatesTo jest pusty. Analiza śladów sieci dla wymiany metadanych HTTP Inspekcja komunikatu pokazuje, że element RelatesTo nie jest obecny ani pusty.
Wartość elementu RelatesTo w komunikacie GetResponse nie jest zgodna z wartością elementu MessageId z odpowiedniego komunikatu Get. Inspekcja śladów sieci dla wymiany metadanych HTTP Inspekcja komunikatu pokazuje, że element RelatesTo zawiera źle sformułowaną lub niepoprawną wartość.

Przewodnik rozwiązywania problemów z interfejsem WSDAPI

  • Last updated on