| Предыдущий | Следующий |
| NS_S_PUBLISHING_POINT_STARTED_WITH_FAILED_SINKS | NS_S_DRM_INDIVIDUALIZED |
NS_S_DRM_LICENSE_ACQUIRED
Лицензия Windows Media DRM получена
NS_S_DRM_LICENSE_ACQUIRED — это HRESULT 861990 (0x000D2726) Windows Media. В AllStat он описан как «лицензия получена». В автомате состояний Windows Media Player, Windows Media Format, DRM или Media Foundation это успешное, но содержательно значимое состояние, которое нельзя сводить к обычному S_OK.
Высокоуровневый запрос, вернувший этот статус , считается завершённым только после того, как вызывающая сторона проверит обозначенное этим результатом состояние.
Что должно быть истинно перед принятием результата
Убедитесь, что полученная лицензия относится к нужному идентификатору содержимого и запрошенному действию и доступна из требуемого контекста пользователя или компьютера. Для этого статуса такая проверка не позволяет принять частично пригодное состояние за полное завершение.
Для этого статуса также убедитесь, что возвращённые данные относятся к текущему поколению операции, а не унаследованы от предыдущей попытки.
Где встречается этот статус
- Этот статус может появляться в 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 может превратить нормальное продолжение или частичный результат в ошибочный повтор либо ложное завершение.
Последовательность диагностики
- Зафиксируйте исходные
0x000D2726иNS_S_DRM_LICENSE_ACQUIREDдо того, как исключения, знаковое форматирование или общая оболочка успеха удалят символическое значение. - Определите интерфейс, метод, callback, службу, драйвер или broker, вернувший этот статусвключая версию компонента, процесс, поток и correlation ID.
- Докажите решающее условие для этого статуса : полученная лицензия должна соответствовать идентификатору содержимого и запрошенному действию и открываться из требуемого контекста пользователя или компьютера.
- Для этого статуса проверьте каждый выходной параметр, счётчик, дескриптор объекта, callback, элемент очереди, media item, отчёт, транзакцию, элемент topology или signaling response, созданные вызовом.
- Сравните состояние непосредственно до и после этого статуса и убедитесь, что владение, время жизни, сохранение и видимые пользователю эффекты соответствуют статусу.
- Воспроизведите этот статус на минимальном входе, затем измените только предполагаемую причину и убедитесь, что возвращаемое значение или постусловие изменилось ожидаемым образом.
Данные и телеметрия
- Сохраните идентификаторы содержимого и лицензии.
- Сохраните запрошенное право.
- Сохраните URL получения лицензии и результат.
- Сохраните срок действия и счётчики лицензии.
- Сохраните результат проверки прав после получения лицензии.
Для этого статуса также зафиксируйте время UTC, идентификаторы процесса и потока, версию компонента, поколение операции и correlation ID. Не помещайте чувствительное содержимое в журналы; используйте длины, хэши, GUID и разрешённые политикой метаданные.
Правильная обработка и восстановление
Сохраните лицензию через поддерживаемое хранилище DRM, заново проверьте права и продолжите исходную операцию. Не записывайте в журналы содержимое лицензии или ключи.
Перед повторным выполнением работы после этого статусасогласуйте побочные эффекты и докажите идемпотентность следующей попытки.
Практический сценарий
Для защищённого файла проигрыватель получает лицензию, затем заново открывает сведения о правах, проверяет число разрешённых воспроизведений и срок действия и продолжает работу без повторного получения лицензии при каждом запуске.
Регрессионный тест должен воспроизвести этот статус, проверить все соответствующие выходные данные и состояние, затем измените только решающее условие и убедитесь в обычном завершении или ожидаемом соседнем результате.
Отличие от соседних результатов
NS_S_DRM_NEEDS_INDIVIDUALIZATION означает, что компоненты безопасности требуется обновить; данное состояние сообщает, что само получение лицензии уже завершено.
Точная классификация этого статуса позволяет выбрать правильный путь ожидания, остановки, повтора, очистки или уведомления пользователя.
Рекомендации разработчикам и администраторам
Когда При передаче результата через границы COM, RPC, управляемого кода, сценариев, драйвера или службы сохраняйте его беззнаковое 32-битное значение. Модульные тесты для этого статуса должны проверять постусловие конкретного кода, а не только успешность по severity.
Полный сброс системы после этого статуса не оправдан, если данные именно по этому коду не указывают на общесистемную причину. Явно определите, кто отвечает за продолжение, отмену, очистку, резервный путь и сообщение пользователю для этого статуса.
Ссылки
- Microsoft: коды ошибок и успешных результатов Windows Media Format SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Windows Media Player SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Media Foundation SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: значения HRESULT — официальный материал Microsoft, относящийся к этому статусу.
Нужно найти другой код? Найти другой код состояния или ошибки.