Что означает код HRESULT 0x000D10DB (NS_S_NEED_TO_BUY_BURN_RIGHTS)?

 
Предыдущий Следующий
NS_S_WMG_ADVISE_DROP_TO_KEYFRAME NS_S_WMPCORE_PLAYLISTCLEARABORT

NS_S_NEED_TO_BUY_BURN_RIGHTS

Для записи носителя требуется приобрести права на запись

NS_S_NEED_TO_BUY_BURN_RIGHTS — это HRESULT 856283 (0x000D10DB) Windows Media. В AllStat он описан как «прав на запись нет; при попытке записать этот файл на аудио-CD пользователю будет предложено приобрести такие права». Бит severity указывает на неошибочный результат, однако значение передаёт конкретное состояние, которое нельзя сводить к обычному S_OK.

В устаревшем конвейере Windows Media или состоянии Player этот статус означает отсутствие прав на запись: при попытке записать файл на аудио-CD пользователю будет предложено приобрести их. Нельзя считать операцию обычно завершённой только по этому статусу , пока состояние и выходные данные компонента-владельца не согласованы.

Последовательность диагностики

  • Зафиксируйте исходное значение 0x000D10DB до того, как оболочки, знаковое десятичное форматирование, исключения или общая обработка успеха заменят исходный статус.
  • Определите операцию, вернувшую этот статус, включая интерфейс или callback, сборку компонента, поток, процесс и фазу машины состояний.
  • Для этого статуса подтвердите решающее условие: приложение отличает права на воспроизведение от отсутствующих прав на запись аудио-CD и получает явное согласие пользователя до перехода к покупке.
  • Проверьте каждый выходной параметр, счётчик, массив статусов, буфер, callback, состояние задачи, временную метку медиа, голос транзакции или security token, остающийся частью контракта этого статуса.
  • Сравните состояние непосредственно до и после этого статуса; success severity не гарантирует завершения необязательной работы или высокоуровневого действия, которого ожидал вызывающий код.
  • Воспроизведите этот статус на минимальном входе, сохраняющем то же условие, затем измените только зафиксированную причину и повторите операцию.

Где встречается этот статус

  • Этот статус может возвращаться в callbacks источника, reader, writer или renderer Windows Media; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
  • Этот статус может возвращаться при автоматизации через Windows Media Player SDK; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
  • Этот статус может возвращаться в состояниях media graph, playlist, image, rights или buffering; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.

Поскольку этот статус является информационным статусом, языковая оболочка может показать его как успех и скрыть символическое различие. Сохраняйте исходный HRESULT, пока не отработана ветвь, специфичная для этого кода.

Что должно быть истинно перед принятием результата

Для этого статуса проверьте, что приложение отличает права на воспроизведение от отсутствующих прав на запись аудио-CD и получает явное согласие пользователя до перехода к покупке. Только такая проверка контракта подтверждает, что этот статус можно безопасно передать следующему шагу вызывающей стороны.

Возврат этого статуса может происходить уже после наблюдаемых побочных эффектов, поэтому восстановление следует начинать со сверки фактического состояния.

Данные и телеметрия

  • Для этого статуса сохраните идентификаторы содержимого и лицензии.
  • Для этого статуса сохраните запрошенную операцию записи.
  • Для этого статуса сохраните текущие флаги прав.
  • Для этого статуса сохраните URL или процедуру покупки у поставщика.
  • Для этого статуса сохраните состояние лицензии после её получения.

Также зафиксируйте ns_s_need_to_buy_burn_rights_operation, ns_s_need_to_buy_burn_rights_state_before, ns_s_need_to_buy_burn_rights_state_after, время UTC, идентификаторы процесса и потока, версию компонента и идентификатор корреляции. Для безопасной с точки зрения конфиденциальности диагностики NS_S_NEED_TO_BUY_BURN_RIGHTS записывайте метаданные и отпечатки вместо конфиденциальных исходных значений.

Отличие от соседних результатов

Этот статус нужно отличать от обычного S_OK и от значений того же семейства API, у которых бит severity указывает на сбой; документированное состояние определяет следующее действие.

Для этого статуса соседний HRESULT может изменить владение объектом, допустимость выходных данных или разрешённый следующий метод.

Правильная обработка и восстановление

Не начинайте запись. Покажите требование к правам и доверенную процедуру покупки, а после получения прав заново проверьте лицензию.

Повторяйте операцию только если документированно изменился входной параметр или состояние. Перед новым вызовом после этого статусаубедитесь, что уже выполненные побочные эффекты либо идемпотентны, либо согласованы с фактическим состоянием.

Практический сценарий

Защищённая дорожка нормально воспроизводится, но прав на запись нет. Проигрыватель исключает её из очереди записи, пока пользователь не завершит процедуру покупки у поставщика.

Регрессионный тест должен воспроизвести этот статус, проверить соответствующие выходные данные и состояние, затем изменить только решающее условие и убедиться в ожидаемом соседнем результате или обычном завершении.

Рекомендации разработчикам и администраторам

Когда этот статус проходит через границы COM, RPC, managed code, scripting или logging, сохраняйте беззнаковое 32-битное значение. Тесты должны проверять постусловие этого статуса, а не только то, что бит severity означает успех.

Для этого статуса явно определите владельца повторной попытки, отмены, очистки и сообщения пользователю. Для этого статуса используйте средства подсистемы, которая выдала результат, а не общую очистку, не способную восстановить её контракт.

Ссылки

Нужно найти другой код? Найти другой код состояния или ошибки.