| Previous | Next |
| NS_S_OPERATION_PENDING | NS_S_NAVIGATION_COMPLETE_WITH_ERRORS |
NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE
Track purchase requires buying the full album
NS_S_TRACK_BUY_REQUIRES_ALBUM_PURCHASE is HRESULT 856921 (0x000D1359) from Windows Media. AllStat describes it as “The file is only available for purchase when you buy the entire album.” In the Windows Media Player, Windows Media Format, DRM, or Media Foundation state machine, the value reports a nonfailure state that must not be collapsed into plain S_OK.
This result is actionable completion information and may require waiting, reconciliation, fallback, or user disclosure.
Where the status is encountered
- Windows Media Player library, playlist, store, or UI plug-in callbacks; capture the exact API, object, and phase because the same numeric success severity does not define the state by itself.
- Windows Media Format source, writer, DRM, publishing-point, or installation operations;
- Media Foundation topology activation and remote-component setup;
Keep it attached to the operation that returned it. Interpreting it outside that API contract can turn a normal continuation or partial result into an incorrect retry or false completion.
What must be true before accepting it
Verify that the catalog offer really restricts the selected track and the displayed price and rights correspond to the album product. Validation of it keeps a success-severity result from becoming a broader promise than the API made.
Also confirm that returned outputs belong to the current operation generation and were not inherited from an earlier attempt.
Correct handling and recovery
Replace the single-track purchase path with an explicit album offer, preserve the selected track context, and require fresh user consent for the broader purchase.
Retry after it only when a recorded input, capability, resource, policy, or state has changed.
Difference from nearby results
This differs from unavailable media: the content is purchasable, but only through a different product scope.
The distinction around it should be visible in control flow, telemetry classification, and user messaging.
Practical scenario
A user clicks Buy on one track and receives this status. The store shows the album SKU, total price, included tracks, and asks for confirmation instead of silently purchasing more content.
References
- Microsoft: Windows Media Format SDK error and success codes
- Microsoft: Windows Media Player SDK
- Microsoft: Media Foundation SDK
- Microsoft: HRESULT values
Looking for a different code? Search another status or error code.
