| Предыдущий | Следующий |
| NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE | NS_S_TRACK_ALREADY_DOWNLOADED |
NS_S_NAVIGATION_COMPLETE_WITH_ERRORS
Навигация по каталогу завершена с отсутствующими идентификаторами
NS_S_NAVIGATION_COMPLETE_WITH_ERRORS — это HRESULT 856926 (0x000D135E) Windows Media. В AllStat он описан как «при завершении запрошенной навигации возникли проблемы: в каталоге отсутствуют идентификаторы». В автомате состояний Windows Media Player, Windows Media Format, DRM или Media Foundation это успешное, но содержательно значимое состояние, которое нельзя сводить к обычному S_OK.
Обёртки не должны преобразовывать NS_S_NAVIGATION_COMPLETE_WITH_ERRORS в неразличимое логическое значение до завершения обработки состояния.
Где встречается этот статус
- Этот статус может появляться в callbacks библиотеки, playlist, store или UI plug-in Windows Media Player; фиксируйте точный API, объект и фазу, поскольку одинаковая числовая severity успеха не определяет состояние сама по себе.
- Этот статус может появляться при операциях source, writer, DRM, publishing point или установки Windows Media Format; фиксируйте точный API, объект и фазу, поскольку одинаковая числовая severity успеха не определяет состояние сама по себе.
- Этот статус может появляться при активации topology Media Foundation и настройке удалённых компонентов; фиксируйте точный API, объект и фазу, поскольку одинаковая числовая severity успеха не определяет состояние сама по себе.
Сохраняйте этот статус привязанным к операции, которая его вернула. Интерпретация этого статуса вне контракта этого API может превратить нормальное продолжение или частичный результат в ошибочный повтор либо ложное завершение.
Данные и телеметрия
- Сохраните запрос навигации и целевой объект.
- Сохраните отсутствующие идентификаторы каталога.
- Сохраните поколение или версию каталога.
- Сохраните сведения о разрешённых и неразрешённых узлах.
- Сохраните результат восстановления или обновления.
Для этого статуса также зафиксируйте время UTC, идентификаторы процесса и потока, версию компонента, поколение операции и correlation ID. Не помещайте чувствительное содержимое в журналы; используйте длины, хэши, GUID и разрешённые политикой метаданные.
Что должно быть истинно перед принятием результата
Убедитесь, что возвращённый целевой объект пригоден для использования, а все отсутствующие идентификаторы явно отмечены, чтобы зависимые функции не считали путь каталога полным. Без проверки NS_S_NAVIGATION_COMPLETE_WITH_ERRORS HRESULT может скрыть устаревший результат, незавершённое владение состоянием или пропущенную работу.
Для этого статуса также убедитесь, что возвращённые данные относятся к текущему поколению операции, а не унаследованы от предыдущей попытки.
Правильная обработка и восстановление
Покажите доступный целевой объект, запишите неразрешённые идентификаторы и отключите либо восстановите действия, которым требуются отсутствующие записи каталога. Перед повторной навигацией обновите данные каталога.
Не запускайте для этого статуса неизменяемый плотный цикл повторных попыток: он может дублировать побочные эффекты или скрыть конечное состояние.
Последовательность диагностики
- Зафиксируйте исходные
0x000D135EиNS_S_NAVIGATION_COMPLETE_WITH_ERRORSдо того, как исключения, знаковое форматирование или общая оболочка успеха удалят символическое значение. - Определите интерфейс, метод, callback, службу, драйвер или broker, вернувший этот статусвключая версию компонента, процесс, поток и correlation ID.
- Докажите решающее условие для этого статуса : возвращённый целевой объект должен оставаться пригодным для использования, а все отсутствующие идентификаторы — быть явно отмечены, чтобы зависимые функции не считали путь каталога полным.
- Для этого статуса проверьте каждый выходной параметр, счётчик, дескриптор объекта, callback, элемент очереди, media item, отчёт, транзакцию, элемент topology или signaling response, созданные вызовом.
- Сравните состояние непосредственно до и после этого статуса и убедитесь, что владение, время жизни, сохранение и видимые пользователю эффекты соответствуют статусу.
- Воспроизведите этот статус на минимальном входе, затем измените только предполагаемую причину и убедитесь, что возвращаемое значение или постусловие изменилось ожидаемым образом.
Отличие от соседних результатов
При обычном завершении навигации цепочка идентификаторов полна; здесь результат пригоден для использования, но в каталоге остаются дефекты.
Для этого статуса соседний результат может означать окончательный вывод, необходимость дополнительной работы или переход к резервному варианту.
Рекомендации разработчикам и администраторам
В панелях мониторинга классифицируйте этот статус по фактическому состоянию — ожидание, частичный результат, завершение, идемпотентность, перенаправление, деградация или действие политики — а не объединяйте его с обычным успехом.
Для этого статуса минимальное целевое изменение состояния лучше всего подтверждает, что диагностированное условие действительно было причиной. Явно определите, кто отвечает за продолжение, отмену, очистку, резервный путь и сообщение пользователю для этого статуса.
Практический сценарий
Навигация в магазине доходит до страницы альбома, но не может разрешить два связанных идентификатора исполнителя. Страница открывается, диагностика показывает повреждённые ссылки, а скрываются только зависящие от них элементы.
Регрессионный тест должен воспроизвести этот статус, проверить все соответствующие выходные данные и состояние, затем измените только решающее условие и убедитесь в обычном завершении или ожидаемом соседнем результате.
Ссылки
- Microsoft: коды ошибок и успешных результатов Windows Media Format SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Windows Media Player SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Media Foundation SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: значения HRESULT — официальный материал Microsoft, относящийся к этому статусу.
Нужно найти другой код? Найти другой код состояния или ошибки.