Устранение неполадок: Начало работы с WSDAPI
Это руководство по устранению неполадок содержит набор процедур диагностики , которые можно использовать для выявления причины проблем с приложением. После успешного определения причины проблемы предлагаемые решения в процедуре диагностики можно применить для устранения проблемы.
Существует два способа определить используемую процедуру диагностики. Один из способов — перейти на страницу устранения неполадок для типа клиента, чтобы просмотреть пошаговый список диагностических процедур, используемых для устранения неполадок клиента. Другой способ — перейти к краткому справочнику по устранению неполадок ниже, чтобы просмотреть сводные таблицы, показывающие распространенные проблемы с приложениями WSDAPI и процедурами для диагностики проблем.
В следующих разделах показаны соответствующие процедуры диагностики по типу клиента. В этих разделах также показаны шаблоны сообщений, связанные с типом клиента.
- устранение неполадок приложений WSDAPI с помощью перенаправленного обнаружения
- устранение неполадок с клиентами обнаружения функций
- устранение неполадок с людьми рядом со мной или собраниями рядом со мной
- Устранение неполадок с мастером добавления принтера
- Устранение неполадок сетевого обозревателя
- Устранение неполадок в мастере настройки проектора
- устранение неполадок с другими приложениями WSDAPI
В следующих таблицах показаны проблемы, которые могут помешать обнаружению клиентов и узлов WSDAPI в сети и обмену данными устройства. В таблицах также показаны процедуры диагностики для выполнения и критерии, используемые для оценки того, страдает ли приложение от конкретной проблемы.
| Проблема | Процедура диагностики | Идентификация проблем |
|---|---|---|
| Брандмауэр блокирует трафик обнаружения сети. | проверка параметров адаптера и брандмауэра | Включение исключения обнаружения сети в брандмауэре решает проблему. |
| Исключения брандмауэра, относящиеся к приложению, блокируют сообщения. | проверка параметров адаптера и брандмауэра | Отключение брандмауэра решает проблему. WF.msc отображает правила брандмауэра для конкретного приложения. |
| Устройство не отвечает на запросы UDP, своевременно отправляя сообщения ProbeMatches или ResolveMatches (в течение 4 секунд). | проверка параметров адаптера и брандмауэра | Отключение брандмауэра решает проблему, и универсальный хост, который отвечает за менее чем 4 секунды, успешно работает. |
| Контекст безопасности приложения неверный (то есть клиент и сервер не имеют достаточных разрешений в сети). | Использование универсального узла и клиента для обнаружения по протоколу WS-Discovery или использование универсального узла и клиента для обмена метаданными по протоколу HTTP | Адрес устройства не отображается в выходных данных клиента отладки WSD. Запуск приложения от имени администратора решает проблему. |
| Политика IPSec блокирует сообщения. | Использование универсального хоста и клиента для обнаружения WS-Discovery или Использование универсального хоста и клиента для обмена HTTP-метаданными | Адрес устройства не отображается в выходных данных клиента отладки WSD. Проблема не решена путем отключения брандмауэра. Проблема не может быть воспроизведена на компьютере без каких-либо политик IPSec. |
| Проблема | Процедура диагностики | Идентификация проблем |
|---|---|---|
| Hello, Проверкаили сообщения Разрешение не передаются в сеть, так как приложение неправильно перечисляет многоадресные сетевые интерфейсы. | Использование клиента отладки WSD для проверки многоадресного трафика | Сообщения Hello, Probe или Resolve не отображаются в выходных данных клиента отладки WSD. Пакеты не отображаются в сети. Пакеты не создаются для интерфейса обратного цикла или для других интерфейсов. |
| Пробные сообщения не отправляются через порт 3702 многоадресной рассылкой UDP (для приложений, не использующих переадресованное обнаружение). | проверка трассировки сети для обнаружения WS-UDP | Проверка сообщения показывает, что он был отправлен в неправильный порт. |
| Сообщение зонда не содержит элемент Types, или элемент Types пуст. | проверка сетевых трассировок для UDP WS-обнаружения или проверка сетевых трассировок для приложений с использованием направленного обнаружения | Проверка сообщения показывает, что элемент типов отсутствует или пуст. |
| Элемент типов сообщения Пробы не содержит типов, на которые будет отвечать узел. | проверка сетевых трассировок для обнаружения UDP WS или проверка сетевых трассировок для приложений с использованием направленного обнаружения | Проверка сообщения показывает, что элемент типов содержит неправильное или некорректное значение. |
| Сообщение ProbeMatches не было отправлено как одноадресное сообщение на порт UDP, из которого была отправлена пробы. | Проверка сетевых трассировок для UDP WS-Discovery или анализ сетевых трассировок для приложений с использованием Directed Discovery | Проверка выходных данных показывает, что сообщение ProbeMatches) не было отправлено или было отправлено в неправильный порт.
Примечание. Для приложений с помощью перенаправленного обнаружения ProbeMatches необходимо отправить по протоколу HTTP или HTTPS в ответ на сообщение пробы. |
| Сообщение ProbeMatches не содержит элемент RelatesTo, или элемент RelatesTo пуст. | проверка сетевых трассировок для обнаружения UDP WS-Discovery или проверка сетевых трассировок для приложений, использующих направленное обнаружение, | Проверка сообщения показывает, что элемент RelatesTo отсутствует или пуст. |
| Значение элемента RelatesTo в сообщении ProbeMatches не соответствует значению элемента MessageId в соответствующем сообщении Probe. | Проверка сетевых трассировок для UDP WS-обнаружения или проверка сетевых трассировок для приложений, использующих направленное обнаружение | Проверка сообщения показывает, что элемент RelatesTo содержит искаженное или неправильное значение. |
| Элемент XAddrs, включенный в сообщение ProbeMatches, не соответствует правилам проверки XAddr. | проверка сетевых трассировок для UDP WS-обнаружения или проверка сетевых трассировок для приложений с использованием направленного обнаружения | Проверка сообщения показывает, что XAddrs недействительны. |
| Решить сообщения не отправляются через UDP-многоадресную рассылку на порт 3702 (для приложений, не использующих направленное обнаружение). | Проверка сетевых трассировок для обнаружения UDP WS-Discovery или Проверка сетевых трассировок для приложений, использующих направленное обнаружение | Проверка выходных данных показывает, что сообщение "Разрешить" было отправлено в неправильный порт. |
| Сообщение ResolveMatches не было отправлено одноадресной рассылкой на порт UDP, с которого было отправлено сообщение Resolve. | проверка трассировок сети для UDP WS-Discovery или проверка сетевых трассировок для приложений, использующих направленное обнаружение | Проверка выходных данных показывает, что сообщение ResolveMatches не было отправлено или оно было отправлено в неправильный порт. |
| Проблема | Процедура диагностики | Идентификация проблем |
|---|---|---|
| Адрес транспорта, объявленный хостом, неправильный. | Использование универсального узла и клиента для обмена метаданными HTTP | Проверка XAddrs в выходных данных клиента отладки WSD показывает, что транспортный адрес неправильный или неправильно сформированный. |
| Не удалось установить TCP-подключение для обмена метаданными. | Анализ сетевых трассировок для обмена метаданными HTTP | Выходные данные анализатора пакетов не показывают следующего обмена пакетами:
|
| Клиент не отправил допустимый HTTP-запрос GET. | Инспекция сетевых трассировок для обмена HTTP метаданными | В выходных данных анализатора пакетов не существует HTTP-запроса GET или запрос неправильно сформирован. |
| Клиент не отправил корректное сообщение WS-Transfer Get. | Инспектирование сетевых трассировок для обмена метаданными HTTP | В выходных данных анализатора пакетов отсутствует WS-Transfer сообщение get или сообщение неправильно сформировано. |
| Сервер не прослушивает URL-путь, указанный в запросе GET по протоколу HTTP. | Проверка сетевых трассировок для обмена метаданными HTTP | В выходных данных анализатора пакетов отсутствует HTTP-ответ. |
| Сообщение WS-Transfer Get не содержит элемент To, или элемент To пуст. | анализ трассировок сети для обмена метаданными HTTP | Проверка сообщения показывает, что элемент To отсутствует или пуст. |
| Значение элемента To сообщения WS-Transfer Get не соответствует одному из адресов конечной точки хоста. | Инспекция сетевых трассировок для обмена метаданными HTTP | Проверка сообщения показывает, что значение элемента To не соответствует одному из адресов конечных точек, объявленных в сообщении ProbeMatches узла или ResolveMatches. |
| Сервер не отправил допустимый заголовок ответа HTTP. | Проверка трассировки сети для обмена метаданными HTTP | В выходных данных анализатора пакетов отсутствует HTTP-ответ или запрос имеет неправильный формат. |
| Заголовок http-ответа, отправляемый узлом, указывает, что запрос не может быть завершен. | Проверка сетевых трассировок для обмена метаданными HTTP | Заголовок ответа содержит код состояния, отличный от HTTP/1.1 200. |
| Хост не отправил валидное сообщение GetResponse. | Проверка трассировок сети для обмена метаданными HTTP | В выходных данных анализатора пакетов GetResponse сообщение отсутствует или сообщение неправильно сформировано. |
| Сообщение GetResponse не содержит элемент RelatesTo или элемент RelatesTo пуст. | проверка сетевых трассировок для обмена метаданными HTTP | Проверка сообщения показывает, что элемент RelatesTo отсутствует или пуст. |
| Значение элемента RelatesTo в сообщении GetResponse не соответствует значению элемента MessageId из соответствующего сообщения Get. | Проверка трассировок сети для обмена метаданными HTTP | Проверка сообщения показывает, что элемент RelatesTo содержит искаженное или неправильное значение. |