| Предыдущий | Следующий |
| NS_S_OPERATION_PENDING | NS_S_NAVIGATION_COMPLETE_WITH_ERRORS |
NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE
Для покупки дорожки требуется приобрести весь альбом
NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE — это HRESULT 856921 (0x000D1359) 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 может превратить нормальное продолжение или частичный результат в ошибочный повтор либо ложное завершение.
Что должно быть истинно перед принятием результата
Убедитесь, что предложение каталога действительно ограничивает выбранную дорожку, а показанные цена и права относятся к продукту-альбому. При проверке NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE не позволяет результату с success severity превратиться в более широкое обещание, чем делает API.
Для этого статуса также убедитесь, что возвращённые данные относятся к текущему поколению операции, а не унаследованы от предыдущей попытки.
Данные и телеметрия
- Сохраните идентификаторы дорожки и альбома в каталоге.
- Сохраните предложение и регион продаж.
- Сохраните цены отдельной дорожки и альбома.
- Сохраните состояние прав или подписки.
- Сохраните решение пользователя.
Для этого статуса также зафиксируйте время UTC, идентификаторы процесса и потока, версию компонента, поколение операции и correlation ID. Не помещайте чувствительное содержимое в журналы; используйте длины, хэши, GUID и разрешённые политикой метаданные.
Последовательность диагностики
- Зафиксируйте исходные
0x000D1359иNS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASEдо того, как исключения, знаковое форматирование или общая оболочка успеха удалят символическое значение. - Определите интерфейс, метод, callback, службу, драйвер или broker, вернувший этот статусвключая версию компонента, процесс, поток и correlation ID.
- Докажите решающее условие для этого статуса : предложение каталога действительно должно ограничивать выбранную дорожку, а показанные цена и права — относиться к продукту-альбому.
- Для этого статуса проверьте каждый выходной параметр, счётчик, дескриптор объекта, callback, элемент очереди, media item, отчёт, транзакцию, элемент topology или signaling response, созданные вызовом.
- Сравните состояние непосредственно до и после этого статуса и убедитесь, что владение, время жизни, сохранение и видимые пользователю эффекты соответствуют статусу.
- Воспроизведите этот статус на минимальном входе, затем измените только предполагаемую причину и убедитесь, что возвращаемое значение или постусловие изменилось ожидаемым образом.
Правильная обработка и восстановление
Замените путь покупки отдельной дорожки явным предложением альбома, сохраните контекст выбранной дорожки и запросите новое согласие пользователя на более широкую покупку.
Повторяйте операцию после этого статуса только если изменился зафиксированный входной параметр, возможность, ресурс, политика или состояние.
Отличие от соседних результатов
Это отличается от недоступного содержимого: материал можно купить, но только как часть другого продукта.
Различие для этого статуса должен быть явно представлен в потоке управления, классификации телеметрии и пользовательских сообщениях.
Практический сценарий
Пользователь нажимает «Купить» для одной дорожки и получает это состояние. Магазин показывает SKU альбома, общую цену, состав дорожек и запрашивает подтверждение вместо скрытой покупки дополнительного содержимого.
Регрессионный тест должен воспроизвести этот статус, проверить все соответствующие выходные данные и состояние, затем измените только решающее условие и убедитесь в обычном завершении или ожидаемом соседнем результате.
Рекомендации разработчикам и администраторам
Обрабатывайте этот статус отдельной ветвью до обычного SUCCEEDED(hr) , если допустимость результата или следующий метод отличаются. В телеметрии сохраняйте 0x000D1359, метод NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE , сборку компонента и идентификатор корреляции.
Полный сброс системы после этого статуса не оправдан, если данные именно по этому коду не указывают на общесистемную причину. Явно определите, кто отвечает за продолжение, отмену, очистку, резервный путь и сообщение пользователю для этого статуса.
Ссылки
- Microsoft: коды ошибок и успешных результатов Windows Media Format SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Windows Media Player SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Media Foundation SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: значения HRESULT — официальный материал Microsoft, относящийся к этому статусу.
Нужно найти другой код? Найти другой код состояния или ошибки.