| Предыдущий | Следующий |
| NS_S_WMPCORE_MORE_NODES_AVAIABLE | NS_S_WMPBR_PARTIALSUCCESS |
NS_S_WMPBR_SUCCESS
Резервное копирование или восстановление Windows Media завершено успешно
NS_S_WMPBR_SUCCESS — это HRESULT 856373 (0x000D1135) Windows Media. В AllStat он описан как «резервное копирование или восстановление завершено успешно». В автомате состояний Windows Media Player, Windows Media Format, DRM или Media Foundation это успешное, но содержательно значимое состояние, которое нельзя сводить к обычному S_OK.
Принимая этот статус, нужно подтвердить документированное состояние, а не проверять только SUCCEEDED(hr).
Последовательность диагностики
- Зафиксируйте исходные
0x000D1135иNS_S_WMPBR_SUCCESSдо того, как исключения, знаковое форматирование или общая оболочка успеха удалят символическое значение. - Определите интерфейс, метод, callback, службу, драйвер или broker, вернувший этот статусвключая версию компонента, процесс, поток и correlation ID.
- Докажите решающее условие для этого статуса : все выбранные права, метаданные и артефакты резервной копии должны пройти проверку после операции, а не считаться корректными только из-за успешного статуса.
- Для этого статуса проверьте каждый выходной параметр, счётчик, дескриптор объекта, callback, элемент очереди, media item, отчёт, транзакцию, элемент topology или signaling response, созданные вызовом.
- Сравните состояние непосредственно до и после этого статуса и убедитесь, что владение, время жизни, сохранение и видимые пользователю эффекты соответствуют статусу.
- Воспроизведите этот статус на минимальном входе, затем измените только предполагаемую причину и убедитесь, что возвращаемое значение или постусловие изменилось ожидаемым образом.
Где встречается этот статус
- Этот статус может появляться в 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_WMPBR_PARTIALSUCCESS сообщает об ограничениях; NS_S_WMPBR_SUCCESS означает, что выбранный объём резервного копирования или восстановления завершён без таких пропусков.
Для этого статуса соседний результат может означать окончательный вывод, необходимость дополнительной работы или переход к резервному варианту.
Правильная обработка и восстановление
Завершите операцию, проверьте число элементов и доступность целевого объекта и зафиксируйте идентификатор набора резервной копии. Материалы для восстановления храните как конфиденциальные данные.
Не запускайте для этого статуса неизменяемый плотный цикл повторных попыток: он может дублировать побочные эффекты или скрыть конечное состояние.
Практический сценарий
Резервное копирование прав завершается, после чего приложение проверяет манифест, число файлов и тестовое восстановление и лишь затем заменяет предыдущую защищённую копию.
Регрессионный тест должен воспроизвести этот статус, проверить все соответствующие выходные данные и состояние, затем измените только решающее условие и убедитесь в обычном завершении или ожидаемом соседнем результате.
Рекомендации разработчикам и администраторам
Пакет данных для поддержки по этому статусу должен включать данные первого проявления и эффективную конфигурацию, заменяя учётные данные, лицензионные материалы, приватные медиаданные и пользовательскую информацию специфичными для этого статуса хэшами или стабильными идентификаторами.
Для этого статуса минимальное целевое изменение состояния лучше всего подтверждает, что диагностированное условие действительно было причиной. Явно определите, кто отвечает за продолжение, отмену, очистку, резервный путь и сообщение пользователю для этого статуса.
Ссылки
- Microsoft: коды ошибок и успешных результатов Windows Media Format SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Windows Media Player SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Media Foundation SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: значения HRESULT — официальный материал Microsoft, относящийся к этому статусу.
Нужно найти другой код? Найти другой код состояния или ошибки.