| Previous | Next |
| NS_E_BKGDOWNLOAD_CALLFUNCENDED | NS_E_BKGDOWNLOAD_FAILEDINITIALIZE |
NS_E_BKGDOWNLOAD_WMDUNPACKFAILED
Diagnostic meaning beyond the standard message
The actionable meaning of 0xC00D1268 / NS_E_BKGDOWNLOAD_WMDUNPACKFAILED is extracting and validating a downloaded.wmd package after transfer.
Why the operation can reach this point
The Player’s download manager coordinates an owner window, a plug-in, background job identity, temporary files and final completion or cancellation. A downloaded .wmd package adds an extraction and cataloguing phase after transfer.
Receiving all network bytes is not the same as completing the job, moving the temporary file or successfully unpacking and cataloguing a Windows Media Download package. One concrete reproduction is: network transfer succeeds but the WMD archive or internal playlist is damaged.
Evidence matrix
| Evidence | Why it matters for wmdunpackfailed |
|---|---|
| Producing object and operation | job GUID and Player signature, BITS/job state, expected and actual file count, remote and local names, temporary path, completion/cancel request, plug-in and callback identity, COM apartment, WMD extraction result and first underlying HRESULT |
| Key observation | package path/size, archive entries, border/metafile references and extraction error |
| Controlled comparison | Repeat the producing call after changing only this condition: obtain a complete valid package and retry from a new download job. |
Minimal experiment
- Capture
0xC00D1268, the exact Player/API operation and the first timestamp at which it appears. - Save package path/size, archive entries, border/metafile references and extraction error; do this before ejecting media, reconnecting a device, canceling a job or rebuilding the Player object.
- Correlate the result with job GUID and Player signature, BITS/job state, expected and actual file count, remote and local names, temporary path, completion/cancel request, plug-in and callback identity, COM apartment, WMD extraction result and first underlying HRESULT.
- Reproduce once with the original source and destination, then apply only this change: obtain a complete valid package and retry from a new download job.
Do not collapse it with these results
| Related result | Different condition |
|---|---|
NS_E_BKGDOWNLOAD_CALLFUNCENDED | aborting a callback because the Player/download service is terminating |
NS_E_BKGDOWNLOAD_FAILEDINITIALIZE | starting the overall background-download manager and job database |
NS_E_BKGDOWNLOAD_CALLFUNCTIMEOUT | waiting longer than allowed for a download plug-in callback |
Recovery and verification
Resolve the responsible precondition: Obtain a complete valid package and retry from a new download job. A successful retest must pass the same wmdunpackfailed checkpoint, not merely hide the message in a different UI path.
The transfer and package phases are different
A .wmd file is a package containing media, playlist and optional border resources. A completed HTTP or BITS transfer proves only that the outer file reached the client. Extraction can still fail because the package is truncated, an internal path is invalid, or a required metafile/border resource is missing.
Authoritative documentation
Looking for a different code? Search another status or error code.